Kuinka ladata esitykset .NET:ssa

Aspose.Slides FOSS for .NET lets you open any .pptx tiedosto, tarkastele sen sisältöä ja joko tallenna se takaisin PPTX-muotoon tai pura tiedot siitä. Tämä opas kattaa tiedoston avaamisen, diojen läpikäymisen, muotojen tekstin lukemisen ja tallennuksen pyöräytyksen.

Vaiheittainen opas

Vaihe 1: Asenna paketti

dotnet add package Aspose.Slides.Foss

Vaihe 2: Avaa olemassa oleva esitys

Anna tiedostopolku new Presentation(). Käytä using lausetta varmistamaan siivous.

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

Tuntemattomat XML-osat lähdetiedostossa säilytetään tarkalleen sellaisina: kirjasto ei koskaan poista sisältöä, jota se ei vielä ymmärrä.

Vaihe 3: Tarkastele dioja

Käy läpi kaikki diat ja tulosta niiden indeksi:

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

Vaihe 4: Lue muodon teksti

Käy läpi muodot ja lue teksti muodoista, joilla on 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}");
        }
    }
}

Vaihe 5: Lue asiakirjan ominaisuudet

Pääse käsiksi asiakirjan ydinasetuksiin 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}");

Vaihe 6: Tallenna kierrätyksenä

Kun olet tarkastellut tai muokannut esitystä, tallenna se takaisin PPTX-muotoon:

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

Tallentaminen eri polkuun luo uuden tiedoston. Tallentaminen samaan polkuun korvaa alkuperäisen.

Yleisiä ongelmia ja korjauksia

FileNotFoundException

Tarkista, että polku .pptx tiedosto on oikea suhteessa työhakemistoon. Käytä Path.Combine luotettavaa polunrakennusta varten:

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

Exception: File format is not supported

Kirjasto tukee .pptx (Office Open XML) vain. Vanha .ppt (binary PowerPoint 97-2003) -tiedostoja ei tueta.

Muodoilla ei ole TextFrame-ominaisuutta

Jotkut muodot (Connector, PictureFrame) ei ole TextFrame. Muunna IAutoShape ja tarkista null ennen tekstin käyttämistä.

Usein kysytyt kysymykset

Säilyttääkö lataus kaiken alkuperäisen sisällön?

Kyllä. Tuntemattomat XML-osat säilytetään tarkasti pyöräytysvaiheessa. Kirjasto ei poista mitään XML-sisältöä, jota se ei vielä tunnista.

Voinko ladata salasanasuojatun PPTX‑tiedoston?

Salasanasuojattuja (salattuja) esityksiä ei tueta tässä versiossa.

Voinko poimia upotetut kuvat?

Käytä kuvakokoelmaa: prs.Images palauttaa ImageCollection. Jokaisella kuvalla on ominaisuuksia raakadatan lukemiseen.

Tukeeko lataamista MemoryStreamistä?

Kyllä. The Presentation konstruktori hyväksyy Stream:

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