Jak tworzyć prezentacje w .NET

Jak tworzyć prezentacje w .NET

Aspose.Slides FOSS for .NET umożliwia tworzenie prezentacji PowerPoint w całości w C# bez zależności od Microsoft Office. Ten przewodnik pokazuje, jak utworzyć nową prezentację, dodać slajdy i kształty, sformatować tekst oraz zapisać wynik.

Przewodnik krok po kroku

Krok 1: Zainstaluj pakiet

Zainstaluj Aspose.Slides FOSS z NuGet. Wymagany jest .NET 9.0 lub nowszy.

dotnet add package Aspose.Slides.Foss

Sprawdź instalację:

using Aspose.Slides.Foss;

using var prs = new Presentation();
Console.WriteLine("Aspose.Slides FOSS ready");

Nie są wymagane żadne inne pakiety systemowe.


Krok 2: Importuj wymagane przestrzenie nazw

Dodaj przestrzenie nazw potrzebne do tworzenia i zapisywania prezentacji.

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

Wszystkie stałe typu kształtu znajdują się w Aspose.Slides.Foss.ShapeType. Wszystkie typy formatowania (FillType, NullableBool) są również w Aspose.Slides.Foss.


Krok 3: Utwórz prezentację

Użyj new Presentation() z instrukcją using. Nowa prezentacja zaczyna się od jednego pustego slajdu.

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

using var prs = new Presentation();
Console.WriteLine($"Slides in new presentation: {prs.Slides.Count}");
// work with prs
prs.Save("output.pptx", SaveFormat.Pptx);

Ważne: Zawsze używaj Presentation z oświadczeniem using. Klasa implementuje IDisposable i zasoby nie zostaną poprawnie zwolnione bez tego.


Krok 4: Uzyskaj dostęp do slajdu

Pierwszy slajd ma indeks 0. Pusta prezentacja ma dokładnie jeden slajd.

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

using var prs = new Presentation();
var slide = prs.Slides[0];  // zero-based index
Console.WriteLine($"Slide at index 0: {slide}");
prs.Save("output.pptx", SaveFormat.Pptx);

Krok 5: Dodaj kształt

Użyj slide.Shapes.AddAutoShape(), aby dodać AutoShape. Parametry to (shapeType, x, y, width, height), wszystkie w punktach (1 punkt = 1/72 cala; standardowy slajd ma wymiary 720 × 540 pt).

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

using var prs = new Presentation();
var slide = prs.Slides[0];

// Rectangle at (50, 50) with 400 wide and 120 tall
var shape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 50, 50, 400, 120);

// Attach a text frame
shape.AddTextFrame("Hello from Aspose.Slides FOSS!");

prs.Save("with-shape.pptx", SaveFormat.Pptx);

Krok 6: Zapisz prezentację

Wywołaj prs.Save(path, SaveFormat.Pptx) przed zwolnieniem obiektu. PPTX jest jedynym obsługiwanym formatem wyjściowym.

prs.Save("result.pptx", SaveFormat.Pptx);

Plik jest zapisywany atomowo; jeśli wystąpi błąd przed tym wywołaniem, nie zostanie utworzony plik wyjściowy.


Kompletny działający przykład

Poniższy program tworzy prezentację składającą się z dwóch slajdów, z kształtem tytułu na pierwszym slajdzie i tabelą na drugim.

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

using var prs = new Presentation();

// --- Slide 1: title shape ---
var slide1 = prs.Slides[0];
var title = slide1.Shapes.AddAutoShape(ShapeType.Rectangle, 40, 40, 640, 80);
var tf = title.AddTextFrame("Q1 Results: Executive Summary");
var fmt = tf.Paragraphs[0].Portions[0].PortionFormat;
fmt.FontHeight = 32;
fmt.FontBold = NullableBool.True;
fmt.FillFormat.FillType = FillType.Solid;
fmt.FillFormat.SolidFillColor.Color = Color.FromArgb(255, 0, 70, 127);

// --- Slide 2: table ---
prs.Slides.AddEmptySlide(prs.LayoutSlides[0]);
var slide2 = prs.Slides[1];
var table = slide2.Shapes.AddTable(40, 40,
    new double[] { 200.0, 120.0, 120.0 },
    new double[] { 40.0, 40.0, 40.0 });

string[] headers = { "Region", "Revenue", "Growth" };
string[][] data = {
    new[] { "North", "$1.2M", "+8%" },
    new[] { "South", "$0.9M", "+4%" },
};

for (int col = 0; col < headers.Length; col++)
    table.Rows[0][col].TextFrame.Text = headers[col];

for (int row = 0; row < data.Length; row++)
    for (int col = 0; col < data[row].Length; col++)
        table.Rows[row + 1][col].TextFrame.Text = data[row][col];

prs.Save("q1-results.pptx", SaveFormat.Pptx);
Console.WriteLine("Saved q1-results.pptx");

Typowe problemy i rozwiązania

ObjectDisposedException

Używasz obiektu Presentation po zakończeniu bloku using. Wszystkie operacje muszą zostać wykonane przed zwolnieniem obiektu.

Błąd brakującej przestrzeni nazw dla ShapeType

Upewnij się, że masz using Aspose.Slides.Foss; na początku swojego pliku. ShapeType, NullableBool, FillType i inne wyliczenia znajdują się w tej przestrzeni nazw.

SaveFormat poza Pptx

Przekazanie dowolnej wartości SaveFormat innej niż SaveFormat.Pptx nie powoduje wyrzucenia wyjątku. Parametr format jest cicho ignorowany i zawsze tworzony jest PPTX. Zawsze używaj SaveFormat.Pptx, aby być jednoznacznym.


Najczęściej zadawane pytania

Jaki jest domyślny rozmiar slajdu?

Nowy Presentation() tworzy slajdy w standardowym rozmiarze 10 × 7,5 cala (720 × 540 punktów). Zmiana rozmiaru slajdu nie jest jeszcze obsługiwana w tej edycji.

Czy mogę dodać więcej niż jeden slajd?

Tak. Wywołaj prs.Slides.AddEmptySlide(prs.LayoutSlides[0]), aby dodać pusty slajd i uzyskać do niego dostęp po indeksie:

prs.Slides.AddEmptySlide(prs.LayoutSlides[0]);
var slide2 = prs.Slides[1];

Czy mogę otworzyć istniejący plik i dodać slajdy?

Tak:

using var prs = new Presentation("existing.pptx");
prs.Slides.AddEmptySlide(prs.LayoutSlides[0]);
prs.Save("existing.pptx", SaveFormat.Pptx);

Jakie formaty mogę zapisać?

Obsługiwany jest tylko SaveFormat.Pptx. Eksport do PDF, HTML, SVG lub obrazów nie jest dostępny w tej edycji.


Zobacz także

 Polski