Jak rozpocząć pracę z Aspose.Slides FOSS dla .NET

Aspose.Slides.Foss dla .NET jest darmową, licencjonowaną na licencji MIT biblioteką do tworzenia i edytowania plików PowerPoint .pptx — nie wymaga Microsoft Office, dostępna w NuGet.

Przewodnik krok po kroku

Krok 1: Zainstaluj pakiet

Zainstaluj z NuGet (wymagany .NET 9.0 lub nowszy):

dotnet add package Aspose.Slides.Foss

Zweryfikuj instalację, budując projekt:

dotnet build

Krok 2: Importuj wymagane przestrzenie nazw

Dodaj dyrektywy using, które są potrzebne do ładowania prezentacji i zapisywania:

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

Krok 3: Utwórz prezentację

Utwórz Presentation bez argumentów, aby rozpocząć od jednego pustego slajdu. Zawsze używaj using, aby zapewnić zwolnienie zasobów wewnętrznych:

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

Krok 4: Dodaj kształt z tekstem

Użyj slide.Shapes.AddAutoShape(), aby wstawić prostokąt, a następnie wywołaj AddTextFrame() aby dodać treść tekstową:

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

Krok 5: Zastosuj wypełnienie i zapisz

Ustaw jednolity kolor wypełnienia kształtu przed zapisaniem:

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

Typowe problemy i rozwiązania

TypeLoadException lub DllNotFoundException
Upewnij się, że kierujesz się na .NET 9.0 lub nowszy. Biblioteka wymaga .NET 9.0+. Zaktualizuj swój
.csproj plik: <TargetFramework>net9.0</TargetFramework>

UnsupportedOperationException przy wywoływaniu niektórych metod
Niektóre funkcje (wykresy, animacje, eksport PDF) nie są obsługiwane w tej wersji.
Sprawdź dokumentację API, aby uzyskać listę ograniczeń przed użyciem zaawansowanych funkcji.

ObjectDisposedException po bloku using Nie używaj instancji Presentation poza jej blokiem using. Uzyskaj dostęp do wszystkich slajdów, kształtów i ramek tekstowych przed zakończeniem bloku using.

Plik nie zapisany prawidłowo Zawsze przekaż wartość wyliczenia SaveFormat do Save(). Przeciążenie Save(path, SaveFormat.Pptx) zapisuje plik w formacie PPTX.

Najczęściej zadawane pytania

Czy Aspose.Slides.Foss wymaga Microsoft Office?

Nie. Biblioteka tworzy i odczytuje pliki .pptx natywnie w czystym C# bez zależności od Microsoft Office, automatyzacji COM ani interfejsów API Windows.

Jakie wersje .NET są obsługiwane?

.NET 9.0 lub nowszy. Biblioteka działa na systemach Windows, macOS, Linux oraz w kontenerach Docker.

Czy biblioteka jest darmowa do użytku komercyjnego?

Tak. Zostało wydane na licencji MIT. Możesz używać, modyfikować i rozpowszechniać je w dowolnym celu, w tym w zastosowaniach komercyjnych.

Czy mogę załadować istniejący plik PPTX?

Tak. Przekaż ścieżkę pliku do konstruktora Presentation:

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

Czy muszę wywoływać metodę Dispose jawnie?

Tak, za pomocą instrukcji using. Presentation implementuje IDisposable i musi być zwolniony, aby zwolnić uchwyty plików i zasoby wewnętrzne.