Wprowadzenie

Aspose.Slides FOSS for .NET is now available on NuGet: a free, MIT-licensed library for creating, reading, and editing PowerPoint .pptx pliki w całości w C#, bez zależności od Microsoft Office ani żadnego własnościowego środowiska uruchomieniowego.

Biblioteka jest przeznaczona dla programistów, którzy potrzebują programowo generować lub manipulować plikami prezentacji: automatyzować zestawy slajdów na podstawie danych, wyodrębniać tekst i metadane z przesłanych plików PPTX, budować pipeline’y raportowania oparte na prezentacjach lub osadzać tworzenie prezentacji w aplikacjach ASP.NET. Ponieważ Aspose.Slides.Foss wymaga .NET 9.0 lub nowszej wersji, jest wdrażana identycznie na Windows, macOS, Linux i w kontenerach Docker.

Kluczowe funkcje

  • Pełne wsparcie round‑trip dla PPTX: Otwórz dowolny .pptx plik, zmodyfikować jego zawartość i zapisać go z powrotem, nie tracąc nieznanych części XML, których biblioteka jeszcze nie rozumie.
  • Zarządzanie slajdami: Dodawaj, usuwaj i iteruj slajdy przy użyciu prs.Slides; prezentacja zaczyna się od jednego pustego slajdu po new Presentation().
  • AutoShapes, Tabele i Łączniki: Wstawiaj kształty za pomocą slide.Shapes.AddAutoShape(), dane tabelaryczne za pomocą slide.Shapes.AddTable(), oraz wizualne łączniki między kształtami za pomocą slide.Shapes.AddConnector().
  • Formatowanie tekstu sformatowanego: Formatuj tekst na poziomie znaków przy użyciu PortionFormat: rozmiaru czcionki, pogrubienia, kursywy, podkreślenia oraz koloru ARGB za pomocą FillType.Solid i ColorFormat.
  • Typy wypełnień: Zastosuj FillType.Solid, Gradient, Pattern, lub Picture wypełnienia do dowolnego kształtu.
  • Efekty wizualne:Cień zewnętrzny, poświata, miękka krawędź, rozmycie, odbicie oraz cień wewnętrzny za pomocą shape.EffectFormat.
  • 3D formatting:Bevel, kamera, zestaw oświetleniowy, materiał oraz głębokość ekstruzji za pomocą shape.ThreeDFormat.
  • Notatki prelegenta: Dołącz tekst notatek do każdego slajdu za pomocą NotesSlideManager.AddNotesSlide().
  • Komentarze wątkowe: Dodaj komentarze z metadanymi autora i pozycją slajdu.
  • Osadzone obrazy: Osadź z ścieżki pliku, bajtów lub Stream.
  • Właściwości dokumentu: Odczyt i zapis podstawowych, aplikacyjnych i niestandardowych właściwości.

Rozpoczęcie

Install from NuGet. .NET 9.0 or later is required.

dotnet add package Aspose.Slides.Foss

Utwórz swoją pierwszą prezentację z kształtem i zapisz ją:

using Aspose.Slides.Foss;

using var prs = new Presentation();
var slide = prs.Slides[0];
var shape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 50, 50, 400, 120);
shape.AddTextFrame("Hello from Aspose.Slides FOSS!");
prs.Save("hello.pptx", SaveFormat.Pptx);

Zawsze używaj Presentation wewnątrz using bloku; zapewnia to, że wszystkie wewnętrzne zasoby są zwalniane po wyjściu z bloku.

Przykład formatowania tekstu

using Aspose.Slides.Foss;

using var prs = new Presentation();
var shape = prs.Slides[0].Shapes.AddAutoShape(ShapeType.Rectangle, 50, 50, 500, 150);
var tf = shape.AddTextFrame("Bold heading in corporate blue");
var fmt = tf.Paragraphs[0].Portions[0].PortionFormat;
fmt.FontHeight = 28;
fmt.FontBold = NullableBool.True;
fmt.FillFormat.FillType = FillType.Solid;
fmt.FillFormat.SolidFillColor.Color = Color.FromArgb(255, 0, 70, 127);
prs.Save("formatted.pptx", SaveFormat.Pptx);

Obecne ograniczenia

Następujące obszary generują NotImplementedException w tym wydaniu:

  • Wykresy, SmartArt i obiekty OLE
  • Animacje i przejścia slajdów
  • Eksport do PDF, HTML, SVG lub formatów obrazów
  • Hiperdłącza, ustawienia akcji, makra VBA i podpisy cyfrowe

Nieznane części XML napotkane podczas ładowania są zachowywane dosłownie przy zapisie, więc pliki PPTX wygenerowane przez inne narzędzia są bezpiecznie odczytywane i zapisywane.

Zobacz także