Kako učitati prezentacije u .NET-u

Aspose.Slides FOSS for .NET omogućuje vam otvaranje bilo koje .pptx datoteke, pregledavanje njenog sadržaja i ili spremanje natrag u PPTX ili izdvajanje podataka iz nje. Ovaj vodič pokriva otvaranje datoteke, iteriranje slajdova, čitanje teksta oblika i round‑tripping spremanja.

Vodič korak po korak

Korak 1: Instalirajte paket

dotnet add package Aspose.Slides.Foss

Korak 2: Otvorite postojeću prezentaciju

Proslijedite putanju datoteke u new Presentation(). Koristite using izjavu kako biste osigurali čišćenje.

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

Nepožnati XML dijelovi u izvornom datoteci očuvani su doslovno: biblioteka nikada ne uklanja sadržaj koji još ne razumije.

Korak 3: Pregledaj slajdove

Iterirajte kroz sve slajdove i ispišite njihov 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");
}

Korak 4: Čitanje teksta oblika

Iterirajte kroz oblike i pročitajte tekst iz oblika koji imaju 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}");
        }
    }
}

Korak 5: Čitanje svojstava dokumenta

Pristupite osnovnim svojstvima dokumenta iz 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}");

Korak 6: Spremi u oba smjera

Nakon pregledavanja ili izmjene prezentacije, spremite je natrag u PPTX:

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

Spremanje na drugu putanju kreira novu datoteku. Spremanje na istu putanju prepisuje original.

Uobičajeni problemi i rješenja

FileNotFoundException

Provjerite je li put do datoteke .pptx ispravan u odnosu na radni direktorij. Koristite Path.Combine za robusnu izgradnju puta:

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

Exception: File format is not supported

Biblioteka podržava .pptx (Office Open XML) samo. Legacy .ppt (binarni PowerPoint 97-2003) datoteke nisu podržane.

Oblici nemaju svojstvo TextFrame

Neki oblici (Connector, PictureFrame) nemaju TextFrame. Pretvorite u IAutoShape i provjerite null prije pristupa tekstu.

Često postavljana pitanja

Preserva li učitavanje sav izvorni sadržaj?

Da. Nepoznati XML dijelovi se čuvaju doslovno pri spremanju u krugu. Biblioteka neće ukloniti bilo koji XML sadržaj koji još ne prepoznaje.

Mogu li učitati PPTX zaštićen lozinkom?

Prezentacije zaštićene lozinkom (šifrirane) nisu podržane u ovoj ediciji.

Mogu li izvući ugrađene slike?

Pristupite zbirci slika: prs.Images vraća ImageCollection. Svaka slika ima svojstva za čitanje sirovih podataka slike.

Je li učitavanje iz MemoryStream‑a podržano?

Da. Konstruktor Presentation prihvaća Stream:

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