Jak ładować prezentacje w .NET

Aspose.Slides FOSS for .NET lets you open any .pptx plik, sprawdź jego zawartość i albo zapisz go ponownie jako PPTX, albo wyodrębnij z niego dane. Ten przewodnik opisuje otwieranie pliku, iterowanie slajdów, odczytywanie tekstu kształtów oraz zapisywanie w trybie round‑trip.

Przewodnik krok po kroku

Krok 1: Zainstaluj pakiet

dotnet add package Aspose.Slides.Foss

Krok 2: Otwórz istniejącą prezentację

Przekaż ścieżkę do pliku do new Presentation(). Użyj a using instrukcji, aby zapewnić sprzątanie.

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

using var prs = new Presentation("input.pptx");
Console.WriteLine($"Slide count: {prs.Slides.Count}");
prs.Save("output.pptx", SaveFormat.Pptx);

Nieznane części XML w pliku źródłowym są zachowywane dosłownie: biblioteka nigdy nie usuwa treści, której jeszcze nie rozumie.

Krok 3: Przeglądaj slajdy

Iteruj po wszystkich slajdach i wypisz ich indeks:

using Aspose.Slides.Foss;

using var prs = new Presentation("deck.pptx");
for (int i = 0; i < prs.Slides.Count; i++)
{
    var slide = prs.Slides[i];
    int shapeCount = slide.Shapes.Count;
    Console.WriteLine($"Slide {i}: {shapeCount} shapes");
}

Krok 4: Odczytaj tekst kształtu

Iteruj po kształtach i odczytuj tekst z kształtów, które mają a TextFrame:

using Aspose.Slides.Foss;

using var prs = new Presentation("deck.pptx");
foreach (var slide in prs.Slides)
{
    foreach (var shape in slide.Shapes)
    {
        if (shape is IAutoShape autoShape && autoShape.TextFrame != null)
        {
            string text = autoShape.TextFrame.Text;
            if (!string.IsNullOrWhiteSpace(text))
                Console.WriteLine($"  Shape text: {text}");
        }
    }
}

Krok 5: Odczytaj właściwości dokumentu

Uzyskaj dostęp do podstawowych właściwości dokumentu z prs.DocumentProperties:

using Aspose.Slides.Foss;

using var prs = new Presentation("deck.pptx");
var props = prs.DocumentProperties;
Console.WriteLine($"Title:   {props.Title}");
Console.WriteLine($"Author:  {props.Author}");
Console.WriteLine($"Subject: {props.Subject}");

Krok 6: Zapisz w trybie round‑trip

Po przeglądzie lub modyfikacji prezentacji zapisz ją ponownie jako PPTX:

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

Zapis pod inną ścieżką tworzy nowy plik. Zapis pod tą samą ścieżką nadpisuje oryginał.

Typowe problemy i rozwiązania

FileNotFoundException

Sprawdź, czy ścieżka do .pptx pliku jest poprawna względem katalogu roboczego. Użyj Path.Combine do solidnej konstrukcji ścieżek:

string path = Path.Combine(AppContext.BaseDirectory, "assets", "deck.pptx");
using var prs = new Presentation(path);

Exception: File format is not supported

Biblioteka obsługuje .pptx (Office Open XML) tylko. Starsze .ppt Pliki (binary PowerPoint 97-2003) nie są obsługiwane.

Kształty nie mają właściwości TextFrame

Niektóre kształty (Connector, PictureFrame) nie mają a TextFrame. Rzutuj na IAutoShape i sprawdź, czy nie jest null przed dostępem do tekstu.

Najczęściej zadawane pytania

Czy wczytywanie zachowuje całą oryginalną zawartość?

Tak. Nieznane części XML są zachowywane w całości przy zapisie round‑trip. Biblioteka nie usuwa żadnych treści XML, których jeszcze nie rozpoznaje.

Czy mogę wczytać zabezpieczony hasłem plik PPTX?

Prezentacje zabezpieczone hasłem (zaszyfrowane) nie są obsługiwane w tej edycji.

Czy mogę wyodrębnić osadzone obrazy?

Uzyskaj dostęp do kolekcji obrazów: prs.Images zwraca ImageCollection. Każdy obraz ma właściwości umożliwiające odczyt surowych danych obrazu.

Czy ładowanie z MemoryStream jest obsługiwane?

Tak. Presentation konstruktor przyjmuje a Stream:

using var stream = new MemoryStream(pptxBytes);
using var prs = new Presentation(stream);
Console.WriteLine($"Slides: {prs.Slides.Count}");