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

Aspose.Slides FOSS برای .NET

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

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

مستندات GitHub

کتابخانه منبع باز .NET برای ارائه‌های PowerPoint

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

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

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

API ارائه و اسلاید

  • ایجاد و باز کردن PPTX: ارائه‌های جدید ایجاد کنید یا فایل‌های .pptx موجود را از طریق new Presentation() یا new Presentation(file) باز کنید.
  • افزودن و حذف اسلایدها: به‌صورت برنامه‌نویسی SlideCollection را با AddClone()، AddEmptySlide()، Remove() و RemoveAt() مدیریت کنید.
  • AutoShapes: مستطیل‌ها، بیضی‌ها، خطوط و سایر ShapeType هندسی‌ها را از طریق AddAutoShape() وارد کنید.
  • جداول و اتصالات: شکل‌های جدول ساختاریافته و خطوط اتصال بین اشکال را از طریق AddConnector() اضافه کنید.
  • یادداشت‌های سخنران: یادداشت‌های سخنران هر اسلاید را از طریق NotesSlideManager بخوانید و بنویسید.
  • نظرات زنجیره‌ای: دسترسی به رشته‌های نظرات سطح اسلاید با GetSlideComments().

جایی که Aspose.Slides FOSS می‌تواند استفاده شود

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

قالب‌بندی متن و افکت‌های بصری

  • قالب‌بندی در سطح کاراکتر: قلم‌های ضخیم، ایتالیک، اندازه قلم و رنگ را به اشیای Portion به‌صورت فردی از طریق PortionFormat اعمال کنید.
  • پر کردن‌های جامد و گرادیان: شکل را با رنگ جامد یا گرادیان خطی چند‑توقفی با استفاده از FillFormat و FillType تنظیم کنید.
  • افکت‌های سایه و درخشندگی: با استفاده از EffectFormat، سایه خارجی، درخشندگی، تاری و انعکاس را به هر شکلی اعمال کنید.
  • تراز پاراگراف: تنظیم تراز چپ، مرکز، راست یا توجیه‌شده برای هر پاراگراف با استفاده از ParagraphFormat.Alignment.
  • Round-trip safe: بخش‌های ناشناخته XML به‌صورت کلمه به کلمه در هنگام ذخیره‌سازی مجدد حفظ می‌شوند.

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

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

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

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

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

dotnet add package Aspose.Slides.Foss

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 - FOSS Aspose.Slides برای .NET چیست؟

این یک کتابخانهٔ رایگان و تحت مجوز MIT، pure-C# برای ایجاد، خواندن و ویرایش ارائه‌های PowerPoint .pptx است که نیازی به Microsoft Office ندارد.

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

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

آیا به Microsoft Office یا PowerPoint نیاز دارد؟

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

چگونه آن را نصب کنم؟

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

آیا می‌توانم افکت‌های بصری مانند سایه و درخشندگی اعمال کنم؟

بله. این کتابخانه اثرات سایهٔ خارجی، درخشندگی، تاری و انعکاس را بر روی هر شیء شکل از طریق API EffectFormat پشتیبانی می‌کند.

آیا الگوی IDisposable توصیه می‌شود؟

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

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

خیر. بخش‌های ناشناختهٔ XML که در هنگام بارگذاری مواجه می‌شوند، به‌صورت دقیق در زمان ذخیره‌سازی حفظ می‌شوند، بنابراین محتوایی که کتابخانه هنوز درک نمی‌کند، هرگز از دست نمی‌رود.

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

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

  

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

 فارسی