1. محصولات
  2.   Aspose.Slides
  3.   Aspose.Slides FOSS for .NET

Aspose.Slides FOSS for .NET

ایجاد، خواندن و ویرایش ارائه‌های PowerPoint از .NET — رایگان و متن‌باز، بدون نیاز به وابستگی Office.

Aspose.Slides FOSS for .NET Aspose.Slides FOSS
for .NET

مستندات GitHub

کتابخانه منبع باز .NET برای ارائه های پاورپوینت

Aspose.Slides FOSS برای .NET یک کتابخانه MIT-licensed pure-C# برای کار با فایل‌های PowerPoint .pptx است. یک بسته NuGet واحد اضافه کنید و بلافاصله شروع به ایجاد، خواندن و ویرایش ارائه‌ها کنید بدون نصب Microsoft Office یا هر زمان‌اجرای مالکیتی.

این کتابخانه یک Presentation API ارائه را که بر پایهٔ Presentation، Slide، Shape، TextFrame، Paragraph و Portion ساخته شده است، مدل مفهومی که خود PowerPoint از آن استفاده می‌کند، افشا می‌کند. اسلایدها را اضافه و حذف کنید، AutoShapes، Tables و Connectors را وارد کنید، متن را در سطح کاراکتر با بولد، ایتالیک، اندازه و رنگ قلم قالب‌بندی کنید، پرکننده‌های ثابت یا گرادیان اعمال کنید، و افکت‌های بصری (shadow, glow, blur, reflection) را اضافه کنید.

الگوی IDisposable تضمین می‌کند که پاک‌سازی منابع به‌صورت قابل اعتماد انجام شود: همیشه یک Presentation را در یک عبارت using بپیچید. بخش‌های ناشناختهٔ XML که در حین بارگذاری مواجه می‌شوند، به‌صورت کلمه به کلمه هنگام ذخیره حفظ می‌شوند، بنابراین round-tripping هرگز محتوایی را که کتابخانه هنوز نمی‌فهمد، خراب نمی‌کند. این کتابخانه به .NET 9.0 یا بالاتر نیاز دارد و هیچ افزونه بومی برای کامپایل ندارد. توسعه‌دهندگانی که به API سازمانی کامل با پشتیبانی کامل تولید نیاز دارند می‌توانند از Aspose.Slides for .NET همراه با این منابع متن‌باز استفاده کنند.

نمایش و API اسلاید

  • Create and open PPTX: ایجاد ارائه‌های جدید یا باز کردن فایل‌های .pptx موجود از طریق new Presentation() یا new Presentation(file).
  • Add and remove slides: به‌صورت برنامه‌نویسی SlideCollection را با AddClone()، AddEmptySlide()، Remove() و RemoveAt() مدیریت کنید.
  • AutoShapes: مستطیل‌ها، بیضی‌ها، خطوط و سایر هندسه‌های ShapeType را از طریق AddAutoShape() وارد کنید.
  • Tables and Connectors: اشکال جدول ساختاریافته و خطوط اتصال‌دهنده بین اشکال را از طریق AddConnector() اضافه کنید.
  • Speaker notes: یادداشت‌های گوینده برای هر اسلاید را از طریق NotesSlideManager بخوانید و بنویسید.
  • Threaded comments: به رشته‌های نظرات در سطح اسلاید با GetSlideComments() دسترسی پیدا کنید.

جایی که Aspose.Slides FOSS می تواند مورد استفاده قرار گیرد

  • ** تولید گزارش:** ساخت سلاید های برند از منابع داده بدون Office.
  • ** اتوماسیون قالب:** پر کردن قالب های PPTX با محتوای پویا در خط لوله CI/CD.
  • ** انتقال محتوا:** خواندن ارائه های موجود و بازسازی یا تغییر سبک اسلاید.
  • ** پشت سر بدون سرور:** فایل های PPTX را در داخل کانتینر Docker یا Azure Functions پردازش کنید.
  • ** پردازش دسته ای:** تغییرات فرمت بندی یکنواخت را در کتابخانه های بزرگ صفحه نمایش اعمال کنید.

فرمت کردن متن و اثرات بصری

  • ** قالب بندی سطح کاراکتر:** استفاده از bold، italic، اندازه فونت و رنگ برای اشیاء Portion به صورت جداگانه از طریق PortionFormat.
  • ** پر کردن جامد و گرادینت:** با استفاده از FillFormat و FillType، شکل پر شدن را به یک رنگ جامدی یا گرادینت خطی چند توقف تنظیم کنید.
  • ** اثر سایه و درخشش:** به هر شکل از طریق EffectFormat، سایه بیرونی، درخشان، مبهم و بازتاب را اعمال کنید.
  • ** تنظیم بند:** تنظیم چپ، مرکز، راست یا توجیه کردن تعدیل در هر بند با استفاده از ParagraphFormat.Alignment.
  • کد سفر دور: قسمت های نامعلوم XML در حفظ مجدد به طور کامل محفوظ می شوند.

تجربه توسعه دهنده

Aspose.Slides FOSS با یک دستور dotnet add package Aspose.Slides.Foss نصب می شود. این کتابخانه خالص C # است بدون هیچ افزونه بومی برای کامپایل و هیچ بسته های سیستم برای نصب.

API مدل شیء PowerPoint را (Presentation، Slide, Shape ، TextFrame , Paragraph و Portion) منعکس می کند بنابراین هر کسی که با مدل شيئۀ پاورپوینت آشنا باشد می تواند از این کتابخانه استفاده کند. این نسخه دارای مجوز MIT است و منبع باز در GitHub است. نیاز به .NET 9.0 یا بالاتر دارد.

یک نمایش و اضافه کردن شکل ایجاد کنید

از یک عبارت using استفاده کنید تا اطمینان حاصل شود که Presentation همیشه آزاد شده و منابع آزاد می‌شوند. AddAutoShape() یک مقدار enum ShapeType می‌گیرد، سپس موقعیت x/y و عرض/ارتفاع را بر حسب نقاط دریافت می‌کند. برای ایجاد فریم متن و تنظیم متن اولیه در یک فراخوانی، AddTextFrame() را صدا بزنید — قبل از فراخوانی AddTextFrame()، به TextFrame دسترسی نداشته باشید زیرا فریم تا زمان ایجاد، مقدار null دارد.

aspose-slides-foss/slides is not yet published — build from source until it ships. See the project README for build instructions.
using Aspose.Slides.Foss;

using var prs = new Presentation();
var slide = prs.Slides[0];

// Add a rectangle AutoShape
var shape = slide.Shapes.AddAutoShape(
    ShapeType.Rectangle, 50, 50, 400, 150
);
shape.AddTextFrame("Hello, Aspose.Slides!");

prs.Save("output.pptx", SaveFormat.Pptx);

فرمت متن و اعمال اثر پر کردن

قالب بندی متن در سطح Portion کوچکترین واحد یک رشته کاراکتر ها عمل می کند. فایل ذخیره شده را باز کنید، به بخش اول پاراگراف اول حرکت کنید و خواص فونت را مستقیما تنظیم کنید. پر کردن شکل مستقل است: FillType را به Solid قرار دهید و رنگ را برای SolidFillColor.Color اختصاص دهید.

using Aspose.Slides.Foss;
using Aspose.Slides.Foss.Drawing;

using var prs = new Presentation("output.pptx");
var shape = (IAutoShape)prs.Slides[0].Shapes[0];
var portion = shape.TextFrame.Paragraphs[0].Portions[0];

// Bold, 18pt, dark-blue text
portion.PortionFormat.FontBold = NullableBool.True;
portion.PortionFormat.FontHeight = 18;
portion.PortionFormat.FillFormat.SolidFillColor.Color =
    Color.FromArgb(255, 0, 0, 139);

// Solid background fill on the shape
shape.FillFormat.FillType = FillType.Solid;
shape.FillFormat.SolidFillColor.Color =
    Color.FromArgb(255, 240, 248, 255);

prs.Save("formatted.pptx", SaveFormat.Pptx);

سوالات متداول

Aspose.Slides FOSS برای .NET چیست؟

این یک کتابخانه رایگان و دارای مجوز MIT برای ایجاد، خواندن و ویرایش ارائه های PowerPoint .pptx بدون نیاز به Microsoft Office است.

چه فرمت های فایل پشتیبانی می شوند؟

.pptx فرمت خواندن / نوشتن پشتیبانی می شود. صادرات به PDF، HTML، SVG یا تصاویر در این نسخه موجود نیست.

آیا این نیاز به مایکروسافت آفیس یا پاورپوینت دارد؟

نه. Aspose.Slides FOSS یک کتابخانه خالص C# است که هیچ وابستگی به Microsoft Office، اتوماسیون COM یا هر زمان اجرا اختصاصی ندارد.

چطوري نصبش کنم؟

dotnet add package Aspose.Slides.Foss را اجرا کنید. این کتابخانه نیاز به .NET 9.0 یا بالاتر دارد. هیچ افزونه بومی ای برای کامپایل وجود ندارد.

ميتونم اثرات بصري مثل سايه و درخشش رو اعمال کنم؟

بله. کتابخانه از اثرات سایه، درخشش، ابراز و بازتاب بیرونی روی هر شیء شکل گرفته شده ای با استفاده از API EffectFormat پشتیبانی می کند.

آیا الگوی ID قابل استفاده توصیه می شود؟

بله. همیشه یک Presentation را در یک بیانیه using (using var prs = new Presentation();) بسته بندی کنید تا اطمینان حاصل شود که پاکسازی منابع قابل اعتماد است.

آیا دور و بر کردن یک PPTX محتوای ناشناخته را نابود می کند؟

نه. قسمت های نامعلوم XML که در هنگام بارگیری پیدا می شوند، به طور لفظی در Save حفظ می شود، بنابراین محتوایی که کتابخانه هنوز درک نمی کند هرگز از دست نخواهد رفت.

کجاش میتونم کد منبع رو پیدا کنم؟

این کتابخانه دارای مجوز MIT است و در GitHub میزبانی می شود. گزارشات خطا و درخواست های کشیدن خوش آمدید هستند.

  

منابع پشتیبانی و آموزش

 فارسی