Presentaties opslaan in .NET

Overzicht

Open Presentations in C# beschrijft hoe je de Presentation klasse gebruikt om een presentatie te openen. Dit artikel legt uit hoe je presentaties maakt en opslaat. De Presentation klasse bevat de inhoud van een presentatie. Of je nu een presentatie vanaf nul maakt of een bestaande wijzigt, je wilt deze opslaan zodra je klaar bent. Met Aspose.Slides for .NET kun je opslaan naar een file of stream. Dit artikel legt de verschillende manieren uit om een presentatie op te slaan.

Presentaties opslaan naar bestanden

Sla een presentatie op naar een bestand door de Save‑methode van de Presentation klasse aan te roepen. Geef de bestandsnaam en het opslagformaat door aan de methode. Het volgende voorbeeld toont hoe je een presentatie opslaat met Aspose.Slides.

// Maak een instantie van de Presentation-klasse die een presentatiedocument vertegenwoordigt.
using (Presentation presentation = new Presentation())
{
    // Voer hier wat werk uit...

    // Sla de presentatie op naar een bestand.
    presentation.Save("Output.pptx", SaveFormat.Pptx);
}

Presentaties opslaan naar streams

Je kunt een presentatie opslaan naar een stream door een output‑stream door te geven aan de Save‑methode van de Presentation klasse. Een presentatie kan naar verschillende stream‑typen worden geschreven. In het onderstaande voorbeeld maken we een nieuwe presentatie en slaan we die op naar een bestands‑stream.

// Maak een instantie van de Presentation-klasse die een presentatiedocument vertegenwoordigt.
using (Presentation presentation = new Presentation())
{
    using (FileStream fileStream = new FileStream("Output.pptx", FileMode.Create))
    {
        // Sla de presentatie op naar de stream.
        presentation.Save(fileStream, SaveFormat.Pptx);
    }
}

Presentaties opslaan met een vooraf gedefinieerd weergavetype

Aspose.Slides stelt je in staat om de initiële weergave in te stellen die PowerPoint gebruikt wanneer de gegenereerde presentatie wordt geopend via de ViewProperties klasse. Stel de eigenschap LastView in op een waarde uit de ViewType enumeratie.

using (Presentation presentation = new Presentation())
{
    presentation.ViewProperties.LastView = ViewType.SlideMasterView;
    presentation.Save("SlideMasterView.pptx", SaveFormat.Pptx);
}

Presentaties opslaan in het Strict Office Open XML‑formaat

Aspose.Slides maakt het mogelijk om een presentatie op te slaan in het Strict Office Open XML‑formaat. Gebruik de PptxOptions klasse en stel bij het opslaan de eigenschap conformance in. Als je Conformance.Iso29500_2008_Strict instelt, wordt het uitvoerbestand opgeslagen in het Strict Office Open XML‑formaat.

Het onderstaande voorbeeld maakt een presentatie en slaat deze op in het Strict Office Open XML‑formaat.

PptxOptions options = new PptxOptions()
{
    Conformance = Conformance.Iso29500_2008_Strict
};

// Maak een instantie van de Presentation-klasse die een presentatiedocument vertegenwoordigt.
using (Presentation presentation = new Presentation())
{
    // Sla de presentatie op in het Strict Office Open XML-formaat.
    presentation.Save("StrictOfficeOpenXml.pptx", SaveFormat.Pptx, options);
}

Presentaties opslaan in Office Open XML‑formaat in Zip64‑modus

Een Office Open XML‑bestand is een ZIP‑archief dat een limiet van 4 GB (2^32 bytes) oplegt aan de ongecomprimeerde grootte van elk bestand, de gecomprimeerde grootte van elk bestand en de totale grootte van het archief, en tevens een limiet van 65 535 (2^16‑1) bestanden. ZIP64‑formatextensies verhogen deze limieten tot 2^64.

De eigenschap IPptxOptions.Zip64Mode laat je kiezen wanneer ZIP64‑formatextensies gebruikt moeten worden bij het opslaan van een Office Open XML‑bestand.

Deze eigenschap biedt de volgende modi:

IfNecessary gebruikt ZIP64‑formatextensies alleen als de presentatie de bovenstaande beperkingen overschrijdt. Dit is de standaardmodus.
Never gebruikt nooit ZIP64‑formatextensies.
Always gebruikt altijd ZIP64‑formatextensies.

De volgende code toont hoe je een presentatie opslaat als een PPTX‑bestand met ingeschakelde ZIP64‑formatextensies:

using (Presentation presentation = new Presentation("Sample.pptx"))
{
    presentation.Save("OutputZip64.pptx", SaveFormat.Pptx, new PptxOptions()
    {
        Zip64Mode = Zip64Mode.Always
    });
}

NOTE

Wanneer je opslaat met Zip64Mode.Never, wordt een PptxException gegooid als de presentatie niet kan worden opgeslagen in ZIP32‑formaat.

Presentaties opslaan in Office Open XML‑formaat met compressieniveaus

Bij het werken met grote presentaties kun je het compressieniveau aanpassen om een balans te vinden tussen bestandsgrootte en verwerkingstijd. Afhankelijk van je behoeften kun je snellere verwerking of kleinere uitvoerbestanden verkiezen.

Aspose.Slides biedt de eigenschap IPptxOptions.CompressionLevel die je in staat stelt het compressieniveau op te geven dat wordt gebruikt bij het opslaan van een presentatie in Office Open XML‑formaat.

De volgende compressieniveaus zijn beschikbaar:

None: Er wordt geen compressie toegepast. Bestanden worden ongewijzigd opgeslagen.
Level1: De snelste compressie met de laagste compressieverhouding.
Level2: Snellere compressie met een iets betere compressieverhouding dan Level1.
Level3: Biedt betere compressie dan Level2 met een gematigde impact op verwerkingstijd.
Level4: Biedt betere compressie dan Level3.
Level5: Biedt verbeterde compressie ten opzichte van Level4 met extra verwerkingstijd.
Level6: Standaardcompressie die een goede balans biedt tussen verwerkingssnelheid en bestandsgrootte. Dit is het standaardcompressieniveau.
Level7: Biedt betere compressie dan Level6 met een tragere verwerking.
Level8: Biedt betere compressie dan Level7.
Level9: Maximale compressie. Levert de kleinste bestandsgrootte op ten koste van de langste verwerkingstijd.

Het volgende voorbeeld toont hoe je een presentatie opslaat als een PPTX‑bestand zonder compressie:

using (Presentation pres = new Presentation("Sample.pptx"))
{
    pres.Save("Sample-out.pptx", SaveFormat.Pptx, new PptxOptions
    {
        CompressionLevel = CompressionLevel.None
    });
}

Dit voorbeeld laat zien hoe je een presentatie opslaat als een PPTX‑bestand met maximale compressie:

using (Presentation pres = new Presentation("Sample.pptx"))
{
    pres.Save("Sample-level9.pptx", SaveFormat.Pptx, new PptxOptions
    {
        CompressionLevel = CompressionLevel.Level9
    });
}

Presentaties opslaan zonder het miniatuurbeeld te vernieuwen

De eigenschap PptxOptions.RefreshThumbnail bepaalt de generatie van miniatuurafbeeldingen bij het opslaan van een presentatie naar PPTX:

Als true, wordt de miniatuur tijdens het opslaan vernieuwd. Dit is de standaardwaarde.
Als false, blijft de huidige miniatuur behouden. Als de presentatie geen miniatuur heeft, wordt er geen gegenereerd.

In de code hieronder wordt de presentatie opgeslagen naar PPTX zonder de miniatuur te vernieuwen.

using (Presentation presentation = new Presentation("Sample.pptx"))
{
    presentation.Save("Output.pptx", SaveFormat.Pptx, new PptxOptions()
    {
        RefreshThumbnail = false
    });
}

Info

Deze optie helpt de tijd te verkorten die nodig is om een presentatie op te slaan in PPTX‑formaat.

Voortgangsupdates bij opslaan in percentage

De interface IProgressCallback wordt gebruikt via de eigenschap ProgressCallback die wordt blootgesteld door de ISaveOptions interface en de abstracte SaveOptions klasse. Ken een implementatie van IProgressCallback toe aan ProgressCallback om voortgangsupdates bij het opslaan te ontvangen als percentage.

De volgende code‑fragmenten tonen hoe je IProgressCallback gebruikt.

ISaveOptions saveOptions = new PdfOptions();
saveOptions.ProgressCallback = new ExportProgressHandler();

using (Presentation presentation = new Presentation("Sample.pptx"))
{
    presentation.Save("Output.pdf", SaveFormat.Pdf, saveOptions);
}

class ExportProgressHandler : IProgressCallback
{
    public void Reporting(double progressValue)
    {
        // Gebruik hier de voortgangspercentagewaarde.
        int progress = Convert.ToInt32(progressValue);

        Console.WriteLine(progress + "% of the file has been converted.");
    }
}

Info

Aspose heeft een gratis PowerPoint‑splits‑app ontwikkeld met behulp van zijn eigen API. De app laat je een presentatie opdelen in meerdere bestanden door geselecteerde dia’s op te slaan als nieuwe PPTX‑ of PPT‑bestanden.

FAQ

Is “fast save” (incremental save) ondersteund zodat alleen wijzigingen worden geschreven?

Nee. Bij het opslaan wordt elke keer het volledige doelbestand gemaakt; incrementeel “fast save” wordt niet ondersteund.

Is het thread‑safe om dezelfde Presentation‑instantie vanuit meerdere threads op te slaan?

Nee. Een Presentation‑instantie is niet thread‑safe; sla deze op vanuit één thread.

Wat gebeurt er met hyperlinks en extern gelinkte bestanden bij het opslaan?

Hyperlinks blijven behouden. Externe gelinkte bestanden (bijv. video’s via relatieve paden) worden niet automatisch gekopieerd – zorg ervoor dat de verwezen paden toegankelijk blijven.

Kan ik document‑metadata (Auteur, Titel, Bedrijf, Datum) instellen/opslaan?

Ja. Standaard documenteigenschappen worden ondersteund en worden bij het opslaan in het bestand geschreven.

Presentaties converteren naar meerdere formaten in .NET Beheer diavoorstelling in .NET