Wie man mit Aspose.Slides FOSS für .NET anfängt

Aspose.Slides.Foss für .NET ist eine kostenlose, MIT-lizenzierte Bibliothek zum Erstellen und Bearbeiten von PowerPoint .pptx Dateien keine Microsoft Office erforderlich, verfügbar auf NuGet.

Schritt für Schritte

Schritt 1: Installieren des Pakets

Installieren von NuGet (.NET 9.0 oder neuer erforderlich):

dotnet add package Aspose.Slides.Foss

Überprüfen Sie die Installation, indem Sie das Projekt erstellen:

dotnet build

Schritt 2: Import der benötigten Namensräume

Fügen Sie die Benutzeranweisungen hinzu, die für das Laden von Präsentationen und das Speichern benötigt werden:

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

Schritt 3: Erstellen Sie eine Präsentation

Konstruktion einer Presentation Die Verwendung von “Wirklichkeit” ist nicht unbedingt nötig. using Sicherstellung der Freigabe interner Ressourcen:

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

Schritt 4: Fügen Sie eine Form mit Text hinzu

Verwendung slide.Shapes.AddAutoShape() Ein rechteckige, dann rufen AddTextFrame() zur Hinzufügung von Textinhalten:

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

Schritt 5: Füllen und Speichern

Setzen Sie eine feste Füllfarbe auf die Form vor dem Speichern:

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

Häufige Probleme und Lösungen

TypeLoadException oder DllNotFoundException Stellen Sie sicher, dass Sie .NET 9.0 oder höher ansprechen. Die Bibliothek benötigt .Net 9.0. Aktualisieren Sie Ihre .csproj Datei: <TargetFramework>net9.0</TargetFramework>

UnsupportedOperationException bei Anrufen bestimmter Methoden Einige Funktionen (Charts, Animationen, PDF-Export) werden in dieser Version nicht unterstützt. Überprüfen Sie die API-Referenz für eine Liste von Einschränkungen, bevor Sie erweiterte Funktionen verwenden.

ObjectDisposedException nach dem using Block Verwenden Sie keine Presentation In diesem Fall ist die using Zugriff auf alle Folien, Die Veröffentlichung der using Verhindern Sie die Ausgänge.

Datei nicht richtig gespeichert Immer eine Pass- SaveFormat Wert der Save().Die Überlastung . Save(path, SaveFormat.Pptx) Schreibt eine PPTX-Format Datei.

Häufig gestellte Fragen

Ist Microsoft Office erforderlich?

Die Bibliothek schafft und liest. .pptx Dateien in reiner C# ohne Abhängigkeit auf Microsoft Office, COM-Automatisierung oder Windows-API.

Welche .NET-Versionen werden unterstützt?

.Die Bibliothek läuft auf Windows, MacOS, Linux und Docker-Containern.

Ist die Bibliothek für kommerzielle Zwecke frei?

Ja, es ist unter der MIT-Lizenz veröffentlicht. Sie können es für jeden Zweck verwenden, ändern und weitergeben, auch für kommerzielle Anwendungen.

Kann ich eine vorhandene PPTX-Datei laden?

Ja, geben Sie den Pfad der Datei an die Presentation Konstrukteur:

using var prs = new Presentation("existing.pptx");
Console.WriteLine($"Loaded {prs.Slides.Count} slides");
prs.Save("copy.pptx", SaveFormat.Pptx);

Muss ich explizit auf Dispose anrufen?

Ja, über die using Erklärungen. Presentation Ausrüstungsgegenstände IDisposable und muss sein. Bereit, Datei-Handys und interne Ressourcen freizugeben.