כיצד להתחיל עם 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 או DllNotFoundException
ודא שאתה ממקד ב‑.NET 9.0 או גרסה מאוחרת יותר. הספרייה דורשת .NET 9.0+. עדכן את קובץ .csproj שלך: <TargetFramework>net9.0</TargetFramework>

UnsupportedOperationException כאשר קוראים לשיטות מסוימות
חלק מהתכונות (charts, animations, ייצוא PDF) אינן נתמכות בגרסה זו.
בדקו את תיעוד ה‑API לקבלת רשימת המגבלות לפני השימוש בתכונות מתקדמות.

ObjectDisposedException אחרי הבלוק using
אל תשתמש במופע Presentation מחוץ לבלוק using שלו. גש לכל השקופיות,
הצורות ומסגרות הטקסט לפני שבלוק using מסתיים.

קובץ לא נשמר כראוי תמיד העבר ערך enum 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 וחייב להיות מתפנה כדי לשחרר ידיות קבצים ומשאבים פנימיים.