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

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

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

چگونه Aspose.Slides FOSS را نصب کنم؟

از NuGet با استفاده از .NET CLI نصب کنید. .NET 9.0 یا بالاتر مورد نیاز است.

dotnet add package Aspose.Slides.Foss

نصب را تأیید کنید:

using Aspose.Slides.Foss;

using var prs = new Presentation();
Console.WriteLine($"Slides: {prs.Slides.Count}");

نیازی به Microsoft Office یا سایر زمان‌های اجرای سیستم نیست.


چرا باید از using var prs = new Presentation(); استفاده کنم؟

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

همیشه این الگو را دنبال کنید:

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

using var prs = new Presentation("input.pptx");
// work here
prs.Save("output.pptx", SaveFormat.Pptx);

به چه فرمت‌های فایلی می‌توانم ذخیره کنم؟

فقط PPTX پشتیبانی می‌شود:

using Aspose.Slides.Foss.Export;

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

صادرات به PDF، HTML، SVG یا فرمت‌های تصویری (PNG، JPEG) در این نسخه موجود نیست.


آیا می‌توانم .ppt (PowerPoint قدیمی 97-2003) فایل‌ها را باز کنم؟

کتابخانه عمدتاً از .pptx (Office Open XML) پشتیبانی می‌کند. سازنده Presentation یک مسیر فایل .ppt را می‌پذیرد و فرمت را تشخیص می‌دهد، اما تجزیه‌وتحلیل قابل اعتماد فایل‌های باینری .ppt تضمین نمی‌شود و در این نسخه مورد استفاده پشتیبانی‌شده‌ای نیست. برای تمام سناریوهای تولید از فایل‌های .pptx استفاده کنید.


چگونه می‌توانم به اسلایدها دسترسی پیدا کنم؟

اسلایدها یک مجموعه صفر‑پایه هستند که از طریق prs.Slides قابل دسترسی است:

var firstSlide = prs.Slides[0];
int slideCount = prs.Slides.Count;

چگونه یک اسلاید دوم اضافه کنم؟

از prs.Slides.AddEmptySlide() با یک طرح استفاده کنید:

using var prs = new Presentation();
var layout = prs.LayoutSlides[0];
prs.Slides.AddEmptySlide(layout);
var slide2 = prs.Slides[1];
prs.Save("two-slides.pptx", SaveFormat.Pptx);

چگونه رنگ پس‌زمینه اسلاید را تنظیم کنم؟

پر کردن پس‌زمینه در این نسخه موجود نیست.


چگونه از NullableBool استفاده کنم؟

NullableBool یک enum سه‌حالت است که برای ویژگی‌های قالب‌بندی استفاده می‌شود. برای بولد، ایتالیک و ویژگی‌های مشابه از NullableBool.True (نه true سی‌شارپ) استفاده کنید:

using Aspose.Slides.Foss;

fmt.FontBold = NullableBool.True;
fmt.FontItalic = NullableBool.False;
fmt.FontUnderline = TextUnderlineType.Single;

چرا تنظیم رنگ متن هیچ تأثیری ندارد؟

قبل از اختصاص رنگ، باید FillType = FillType.Solid را نیز تنظیم کنید:

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

fmt.FillFormat.FillType = FillType.Solid;
fmt.FillFormat.SolidFillColor.Color = Color.FromArgb(255, 200, 0, 0);

آیا می‌توانم از نمودارها یا SmartArt استفاده کنم؟

خیر. نمودارها، SmartArt، اشیای OLE، انیمیشن‌ها، انتقال‌ها، پیوندهای فراگیر، ماکروهای VBA و امضاهای دیجیتال در این نسخه پیاده‌سازی نشده‌اند.


آیا کتابخانه از .NET 8 پشتیبانی می‌کند؟

خیر. .NET 9.0 یا بالاتر مورد نیاز است.


آیا این کتابخانه ایمن برای استفاده در چند رشته است؟

هر شیء Presentation مستقل است. ایجاد و استفاده از نمونه‌های جداگانه Presentation از رشته‌های جداگانه ایمن است به شرطی که یک شیء Presentation را بدون قفل‌گذاری خارجی بین رشته‌ها به اشتراک نگذارید.


چگونه یک تصویر را جاسازی کنم؟

بایت‌های تصویر را بخوانید و به prs.Images اضافه کنید، سپس یک PictureFrame ایجاد کنید:

byte[] imageData = File.ReadAllBytes("logo.png");
var image = prs.Images.AddImage(imageData);
slide.Shapes.AddPictureFrame(ShapeType.Rectangle, 50, 50, 200, 150, image);

همچنین ببینید

 فارسی