باز کردن ارائه‌ها در .NET

مقدمه

فراتر از ایجاد ارائه‌های PowerPoint از ابتدا، Aspose.Slides به شما امکان باز کردن ارائه‌های موجود را نیز می‌دهد. پس از بارگذاری یک ارائه، می‌توانید اطلاعات مربوط به آن را بازیابی کنید، محتوای اسلایدها را ویرایش کنید، اسلایدهای جدید اضافه کنید، اسلایدهای موجود را حذف کنید و کارهای دیگری انجام دهید.

باز کردن ارائه‌ها

برای باز کردن یک ارائه موجود، یک نمونه از کلاس Presentation را ایجاد کنید و مسیر فایل را به سازندهٔ آن پاس دهید.

مثال C# زیر نشان می‌دهد چگونه یک ارائه را باز کنید و تعداد اسلایدهای آن را به‌دست آورید:

// یک نمونه از کلاس Presentation ایجاد کنید و مسیر فایل را به سازنده‌اش پاس دهید.
using (Presentation presentation = new Presentation("Sample.pptx"))
{
    // تعداد کل اسلایدهای موجود در ارائه را چاپ کنید.
    System.Console.WriteLine(presentation.Slides.Count);
}

باز کردن ارائه‌های دارای رمز عبور

زمانی که نیاز به باز کردن ارائه‌ای دارید که با رمز عبور محافظت شده است، رمز عبور را از طریق ویژگی Password کلاس LoadOptions به‌عنوان ورودی بدهید تا آن را رمزگشایی و بارگذاری کنید. کد C# زیر این عملیات را نشان می‌دهد:

LoadOptions loadOptions = new LoadOptions {Password = "YOUR_PASSWORD"};
using (Presentation presentation = new Presentation("Sample.pptx", loadOptions))
{
    // عملیات مورد نیاز را بر روی ارائهٔ رمزگشایی‌شده انجام دهید.
}

باز کردن ارائه‌های بزرگ

Aspose.Slides گزینه‌هایی ارائه می‌دهد—به‌ویژه ویژگی BlobManagementOptions در کلاس LoadOptions—تا به شما در بارگذاری ارائه‌های بزرگ کمک کند.

کد C# زیر بارگذاری یک ارائه بزرگ (به عنوان مثال، ۲ گیگابایت) را نشان می‌دهد:

const string filePath = "LargePresentation.pptx";

LoadOptions loadOptions = new LoadOptions
{
    BlobManagementOptions = 
    {
        // رفتار KeepLocked را انتخاب کنید — فایل ارائه برای طول عمر 
        // نمونهٔ Presentation قفل می‌ماند، اما نیازی به بارگذاری در حافظه یا کپی به فایل موقت نیست.
        PresentationLockingBehavior = PresentationLockingBehavior.KeepLocked,
        IsTemporaryFilesAllowed = true,
        MaxBlobsBytesInMemory = 10 * 1024 * 1024 // 10 MB
    }
};

using (Presentation presentation = new Presentation(filePath, loadOptions))
{
    // ارائهٔ بزرگ بارگذاری شده و می‌تواند استفاده شود، در حالی که مصرف حافظه کم می‌ماند.

    // تغییرات موردنظر را در ارائه اعمال کنید.
    presentation.Slides[0].Name = "Large presentation";

    // ارائه را در فایل دیگری ذخیره کنید. در طول این عملیات مصرف حافظه کم می‌ماند.
    presentation.Save("LargePresentation-copy.pptx", SaveFormat.Pptx);

    // این کار را نکنید! یک استثنای I/O پرتاب می‌شود زیرا فایل تا زمان آزاد شدن شیء Presentation قفل باقی می‌ماند.
    File.Delete(filePath);
}

// این کار در اینجا امن است. فایل منبع دیگر توسط شیء Presentation قفل نشده است.
File.Delete(filePath);

کنترل منابع خارجی

Aspose.Slides اینترفیس IResourceLoadingCallback را ارائه می‌دهد که به شما امکان مدیریت منابع خارجی را می‌دهد. کد C# زیر نشان می‌دهد چگونه از اینترفیس IResourceLoadingCallback استفاده کنید:

LoadOptions loadOptions = new LoadOptions();
loadOptions.ResourceLoadingCallback = new ImageLoadingHandler();

Presentation presentation = new Presentation("Sample.pptx", loadOptions);

public class ImageLoadingHandler : IResourceLoadingCallback
{
    public ResourceLoadingAction ResourceLoading(IResourceLoadingArgs args)
    {
        if (args.OriginalUri.EndsWith(".jpg"))
        {
            try
            {
                // یک تصویر جانشین بارگیری کنید.
                byte[] imageData = File.ReadAllBytes("aspose-logo.jpg");
                args.SetData(imageData);
                return ResourceLoadingAction.UserProvided;
            }
            catch (Exception)
            {
                return ResourceLoadingAction.Skip;
            }
        }
        else if (args.OriginalUri.EndsWith(".png"))
        {
            // یک URL جانشین تنظیم کنید.
            args.Uri = "http://www.google.com/images/logos/ps_logo2.png";
            return ResourceLoadingAction.Default;
        }

        // تمام تصاویر دیگر را رد کنید.
        return ResourceLoadingAction.Skip;
    }
}

بارگذاری ارائه‌ها بدون اشیاء باینری تعبیه‌شده

یک ارائه PowerPoint می‌تواند انواع زیر از اشیاء باینری تعبیه‌شده را داشته باشد:

با استفاده از ویژگی ILoadOptions.DeleteEmbeddedBinaryObjects، می‌توانید یک ارائه را بدون هیچ‌یک از اشیاء باینری تعبیه‌شده بارگذاری کنید.

این ویژگی برای حذف محتوای باینری احتمالی مخرب مفید است. کد C# زیر نحوهٔ بارگذاری یک ارائه بدون هیچ‌گونه محتوای باینری تعبیه‌شده را نشان می‌دهد:

LoadOptions loadOptions = new LoadOptions()
{
	DeleteEmbeddedBinaryObjects = true
}

using (Presentation presentation = new Presentation("malware.ppt", loadOptions))
{
    // عملیات مورد نیاز را بر روی ارائه انجام دهید.
}

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

چگونه می‌توانم بفهمم که یک فایل خراب است و نمی‌توان آن را باز کرد؟

در هنگام بارگذاری، یک استثنای تجزیه/اعتبارسنجی قالب دریافت خواهید کرد. این خطاها معمولاً به ساختار ZIP نامعتبر یا رکوردهای خراب PowerPoint اشاره می‌کنند.

اگر قلم‌های مورد نیاز هنگام باز کردن موجود نباشند چه اتفاقی می‌افتد؟

فایل باز خواهد شد، اما در مراحل بعدی rendering/export ممکن است قلم‌ها جایگزین شوند. برای جلوگیری از این‌مانند، می‌توانید Configure font substitutions یا add the required fonts را به محیط زمان اجرا اضافه کنید.

در مورد رسانه‌های تعبیه‌شده (ویدئو/صدا) هنگام باز کردن چه می‌شود؟

آنها به‌عنوان منابع ارائه در دسترس قرار می‌گیرند. اگر رسانه‌ها از طریق مسیرهای خارجی ارجاع داده شوند، اطمینان حاصل کنید که این مسیرها در محیط شما قابل دسترسی باشند؛ در غیر این صورت rendering/export ممکن است رسانه‌ها را حذف کند.

ایجاد ارائه‌ها در .NET بازخوانی و به‌روزرسانی اطلاعات ارائه در .NET