چگونه ارائه‌ها را در .NET بارگذاری کنیم

Aspose.Slides FOSS for .NET به شما امکان می‌دهد هر فایل .pptx را باز کنید، محتوای آن را بررسی کنید و یا آن را به PPTX ذخیره کنید یا داده‌ها را از آن استخراج کنید. این راهنما شامل باز کردن یک فایل، پیمایش اسلایدها، خواندن متن شکل و ذخیره‌سازی دورانی است.

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

dotnet add package Aspose.Slides.Foss

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

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

using Aspose.Slides.Foss;

using var prs = new Presentation("deck.pptx");
for (int i = 0; i < prs.Slides.Count; i++)
{
    var slide = prs.Slides[i];
    int shapeCount = slide.Shapes.Count;
    Console.WriteLine($"Slide {i}: {shapeCount} shapes");
}

using Aspose.Slides.Foss;

using var prs = new Presentation("deck.pptx");
foreach (var slide in prs.Slides)
{
    foreach (var shape in slide.Shapes)
    {
        if (shape is IAutoShape autoShape && autoShape.TextFrame != null)
        {
            string text = autoShape.TextFrame.Text;
            if (!string.IsNullOrWhiteSpace(text))
                Console.WriteLine($"  Shape text: {text}");
        }
    }
}

using Aspose.Slides.Foss;

using var prs = new Presentation("deck.pptx");
var props = prs.DocumentProperties;
Console.WriteLine($"Title:   {props.Title}");
Console.WriteLine($"Author:  {props.Author}");
Console.WriteLine($"Subject: {props.Subject}");

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

مشکلات رایج و راه‌حل‌ها

FileNotFoundException

اطمینان حاصل کنید که مسیر فایل .pptx نسبت به دایرکتوری کاری صحیح است. برای ساخت مسیر مقاوم از Path.Combine استفاده کنید:

string path = Path.Combine(AppContext.BaseDirectory, "assets", "deck.pptx");
using var prs = new Presentation(path);

Exception: File format is not supported

کتابخانه فقط .pptx (Office Open XML) را پشتیبانی می‌کند. فایل‌های .ppt (PowerPoint باینری 97-2003) قدیمی پشتیبانی نمی‌شوند.

اشکال ویژگی TextFrame ندارند

برخی اشکال (Connector, PictureFrame) یک TextFrame ندارند. به IAutoShape تبدیل کنید و قبل از دسترسی به متن، مقدار null را بررسی کنید.

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

آیا بارگذاری تمام محتوای اصلی را حفظ می‌کند؟

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

آیا می‌توانم یک فایل PPTX محافظت‌شده با رمز عبور را بارگذاری کنم؟

ارائه‌های دارای رمز عبور (رمزگذاری‌شده) در این نسخه پشتیبانی نمی‌شوند.

آیا می‌توانم تصاویر جاسازی‌شده را استخراج کنم؟

دسترسی به مجموعه تصاویر: prs.Images، ImageCollection را برمی‌گرداند. هر تصویر دارای ویژگی‌هایی برای خواندن داده‌های خام تصویر است.

آیا بارگذاری از یک MemoryStream پشتیبانی می‌شود؟

بله. سازندهٔ Presentation یک Stream را می‌پذیرد:

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

موارد مرتبط

• نحوه ایجاد ارائه‌ها در .NET
• نحوه ذخیره‌سازی ارائه‌ها در .NET
• مروری بر ویژگی‌ها
• مرجع API