كيفية البدء مع Aspose.Slides FOSS لـ .NET
Aspose.Slides.Foss لـ .NET هي مكتبة مجانية مرخصة بموجب رخصة MIT لإنشاء وتحرير ملفات PowerPoint .pptx — لا يلزم وجود Microsoft Office، متوفرة على NuGet.
دليل خطوة بخطوة
الخطوة 1: تثبيت الحزمة
التثبيت من NuGet (يتطلب .NET 9.0 أو أحدث):
dotnet add package Aspose.Slides.Fossتحقق من التثبيت عن طريق بناء المشروع:
dotnet buildالخطوة 2: استيراد المساحات الاسمية المطلوبة
أضف توجيهات using التي تحتاجها لتحميل العروض التقديمية وحفظها:
using Aspose.Slides.Foss;
using Aspose.Slides.Foss.Export;الخطوة 3: إنشاء عرض تقديمي
أنشئ Presentation بدون أي معاملات لبدء شريحة فارغة واحدة. استخدم دائمًا
using لضمان تحرير الموارد الداخلية:
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);الخطوة 4: إضافة شكل مع نص
استخدم slide.Shapes.AddAutoShape() لإدراج مستطيل، ثم استدعِ AddTextFrame()
لإضافة محتوى نصي:
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);الخطوة 5: تطبيق تعبئة وحفظ
قم بتعيين لون تعبئة صلبة على الشكل قبل الحفظ:
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 or DllNotFoundException
تأكد من استهداف .NET 9.0 أو أحدث. تتطلب المكتبة .NET 9.0+. حدّث
.csproj الملف: <TargetFramework>net9.0</TargetFramework>
UnsupportedOperationException عند استدعاء بعض الطرق
بعض الميزات (المخططات، الرسوم المتحركة، تصدير PDF) غير مدعومة في هذا الإصدار.
تحقق من مرجع API للحصول على قائمة بالقيود قبل استخدام الميزات المتقدمة.
ObjectDisposedException بعد كتلة using
لا تستخدم مثيل Presentation خارج كتلة using الخاصة به. قم بالوصول إلى جميع الشرائح,
الأشكال وإطارات النص قبل خروج كتلة using.
الملف لم يُحفظ بشكل صحيح
يجب دائمًا تمرير قيمة تعداد SaveFormat إلى Save(). الإصدار المتعدد Save(path, SaveFormat.Pptx)
يكتب ملفًا بتنسيق PPTX.
الأسئلة المتكررة
هل يتطلب Aspose.Slides.Foss Microsoft Office؟
لا. المكتبة تنشئ وتقرأ ملفات .pptx أصليًا بلغة C# النقية دون أي اعتماد على Microsoft Office أو أتمتة COM أو واجهات برمجة تطبيقات Windows.
ما إصدارات .NET المدعومة؟
.NET 9.0 أو أحدث. المكتبة تعمل على Windows و macOS و Linux وحاويات 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 ويجب أن يكون
مُتَخلّصًا لإطلاق مقبضات الملفات والموارد الداخلية.
