چگونه با Aspose.Slides FOSS برای .NET شروع کنیم

Aspose.Slides.Foss برای .NET یک کتابخانه رایگان با مجوز MIT برای ایجاد و ویرایش فایل‌های PowerPoint .pptx است — نیازی به Microsoft Office نیست، در NuGet موجود است.

راهنمای گام به گام

dotnet add package Aspose.Slides.Foss

dotnet build

using Aspose.Slides.Foss;
using Aspose.Slides.Foss.Export;

using Aspose.Slides.Foss;
using Aspose.Slides.Foss.Export;

using var prs = new Presentation();
Console.WriteLine($"Slides: {prs.Slides.Count}");
prs.Save("new_presentation.pptx", SaveFormat.Pptx);

using Aspose.Slides.Foss;
using Aspose.Slides.Foss.Export;

using var prs = new Presentation();
var slide = prs.Slides[0];
var shape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 50, 50, 400, 150);
var tf = shape.AddTextFrame("Hello from Aspose.Slides FOSS!");
var fmt = tf.Paragraphs[0].Portions[0].PortionFormat;
fmt.FontHeight = 24;
fmt.FontBold = NullableBool.True;
prs.Save("with_shape.pptx", SaveFormat.Pptx);

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

using var prs = new Presentation();
var shape = prs.Slides[0].Shapes.AddAutoShape(ShapeType.Rectangle, 100, 100, 400, 200);
shape.FillFormat.FillType = FillType.Solid;
shape.FillFormat.SolidFillColor.Color = Color.FromArgb(255, 70, 130, 180);
shape.AddTextFrame("Styled shape");
prs.Save("styled.pptx", SaveFormat.Pptx);

مسائل رایج و راه‌حل‌ها

TypeLoadException یا DllNotFoundException
اطمینان حاصل کنید که هدف‌گذاری شما بر روی .NET 9.0 یا نسخه‌های بعدی است. این کتابخانه به .NET 9.0+ نیاز دارد. به‌روزرسانی کنید
.csproj فایل: <TargetFramework>net9.0</TargetFramework>

UnsupportedOperationException هنگام فراخوانی برخی متدها
برخی ویژگی‌ها (نمودارها، انیمیشن‌ها، خروجی PDF) در این نسخه پشتیبانی نمی‌شوند.
قبل از استفاده از ویژگی‌های پیشرفته، مرجع API را برای فهرست محدودیت‌ها بررسی کنید.

ObjectDisposedException پس از بلوک using
از یک نمونه Presentation خارج از بلوک using استفاده نکنید. تمام اسلایدها،
اشکال و فریم‌های متنی را قبل از خروج بلوک using دسترسی پیدا کنید.

فایل به‌درستی ذخیره نشد همیشه مقدار enum SaveFormat را به Save() پاس دهید. overload Save(path, SaveFormat.Pptx) یک فایل با فرمت PPTX می‌نویسد.

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

آیا Aspose.Slides.Foss به Microsoft Office نیاز دارد؟

نه. این کتابخانه به‌صورت بومی و در C# خالص فایل‌های .pptx را ایجاد و می‌خواند بدون هیچ‌گونه وابستگی به Microsoft Office، خودکارسازی COM یا APIهای ویندوز.

کدام نسخه‌های .NET پشتیبانی می‌شوند؟

.NET 9.0 یا بعد از آن. کتابخانه بر روی ویندوز، macOS، لینوکس و کانتینرهای Docker اجرا می‌شود.

آیا کتابخانه برای استفاده تجاری رایگان است؟

بله. تحت مجوز MIT منتشر شده است. شما می‌توانید برای
هر منظوری، از جمله برنامه‌های تجاری، از آن استفاده، تغییر و توزیع کنید.

آیا می‌توانم یک فایل PPTX موجود را بارگذاری کنم؟

بله. مسیر فایل را به سازنده Presentation بدهید:

using var prs = new Presentation("existing.pptx");
Console.WriteLine($"Loaded {prs.Slides.Count} slides");
prs.Save("copy.pptx", SaveFormat.Pptx);

آیا باید متد Dispose را به‌صورت صریح فراخوانی کنم؟

بله، از طریق عبارت using. Presentation IDisposable را پیاده‌سازی می‌کند و باید تخلیه شود تا دستگیره‌های فایل و منابع داخلی آزاد شوند.

موارد مرتبط

• سوالات متداول — Aspose.Slides FOSS برای .NET
• نحوه ایجاد ارائه‌ها در .NET
• نحوه افزودن اشکال در .NET
• مستندات شروع کار
• مرجع API