Aspose.Slides FOSS - Aspose.Slides البرمجيات الحرة ومفتوحة المصدر

كيفية تحميل العروض التقديمية في .NET

Aspose.Slides FOSS for .NET lets you open any .pptx الملف، فحص محتواه، وإما حفظه مرة أخرى إلى PPTX أو استخراج البيانات منه. هذا الدليل يغطي فتح ملف، وتشويش الشرائح، وقراءة شكل النص، ودوائر-مخزون الخزانة.

خطوة بخطوة دليل

الخطوة 1: قم بتثبيت الحزمة

dotnet add package Aspose.Slides.Foss

الخطوة 2: افتح عرض موجود

قم بتحويل مسار الملف إلى new Presentation().استخدام أ using إعلانات لضمان التنظيف.

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);

يتم الحفاظ على أجزاء XML غير معروفة في ملف المصدر: لا تقوم المكتبة بإزالة المحتوى الذي لا يفهمه بعد.

الخطوة الثالثة: فحص الشرائح

اقرأ جميع الخصائص و اكتب مؤشرها :

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");
}

الخطوة 4: قراءة النص الشكل

اقرأ المزيد من الاحاديث و اكتب النص من الأشكال التي لديها TextFrame:

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}");
        }
    }
}

الخطوة الخامسة: قراءة ملكية المستندات

الوصول إلى الخصائص الأساسية للوثيقة من prs.DocumentProperties:

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}");

الخطوة 6: Round-Trip Save

بعد فحص أو تعديل العرض التقديمي، حفظه مرة أخرى إلى PPTX:

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لا يوجد لديك A TextFrame.كاست إلى IAutoShape تحقق من صفر قبل الوصول إلى النص.

الأسئلة المتكررة

هل يحفظ تحميل كل المحتوى الأصلي؟?

نعم، يتم حفظ أجزاء 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}");