.NET でプレゼンテーションを保存

概要

C#でプレゼンテーションを開くでは、Presentation クラスを使用してプレゼンテーションを開く方法が説明されています。このガイドでは、プレゼンテーションの作成と保存方法を解説します。Presentation クラスはプレゼンテーションの内容を保持します。最初からプレゼンテーションを作成する場合でも、既存のものを変更する場合でも、作業が完了したら保存したくなります。Aspose.Slides for .NET を使用すると、ファイル または ストリーム に保存できます。本稿では、プレゼンテーションを保存するさまざまな方法を説明します。

ファイルにプレゼンテーションを保存

Presentation クラスの Save メソッドを呼び出すことで、プレゼンテーションをファイルに保存します。メソッドにファイル名と保存形式を渡します。以下の例は、Aspose.Slides を使用してプレゼンテーションを保存する方法を示しています。

// プレゼンテーション ファイルを表す Presentation クラスのインスタンスを作成します。
using (Presentation presentation = new Presentation())
{
    // ここで何らかの処理を行います...

    // プレゼンテーションをファイルに保存します。
    presentation.Save("Output.pptx", SaveFormat.Pptx);
}

ストリームにプレゼンテーションを保存

Presentation クラスの Save メソッドに出力ストリームを渡すことで、プレゼンテーションをストリームに保存できます。プレゼンテーションは多数のストリームタイプに書き込むことが可能です。以下の例では、新しいプレゼンテーションを作成し、ファイルストリームに保存しています。

// プレゼンテーション ファイルを表す Presentation クラスのインスタンスを作成します。
using (Presentation presentation = new Presentation())
{
    using (FileStream fileStream = new FileStream("Output.pptx", FileMode.Create))
    {
        // プレゼンテーションをストリームに保存します。
        presentation.Save(fileStream, SaveFormat.Pptx);
    }
}

事前定義されたビュータイプでプレゼンテーションを保存

Aspose.Slides では、ViewProperties クラスを使用して、生成されたプレゼンテーションが開かれたときに PowerPoint が使用する初期ビューを設定できます。LastView プロパティに ViewType 列挙体の値を設定します。

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

厳密な Office Open XML 形式でプレゼンテーションを保存

Aspose.Slides では、プレゼンテーションを厳密な Office Open XML 形式で保存できます。保存時に PptxOptions クラスの Conformance プロパティを設定します。Conformance.Iso29500_2008_Strict を設定すると、出力ファイルは厳密な Office Open XML 形式で保存されます。

以下の例は、プレゼンテーションを作成し、厳密な Office Open XML 形式で保存する方法を示しています。

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

// プレゼンテーション ファイルを表す Presentation クラスのインスタンスを作成します。
using (Presentation presentation = new Presentation())
{
    // プレゼンテーションを Strict Office Open XML 形式で保存します。
    presentation.Save("StrictOfficeOpenXml.pptx", SaveFormat.Pptx, options);
}

Zip64 モードで Office Open XML 形式のプレゼンテーションを保存

Office Open XML ファイルは ZIP アーカイブであり、未圧縮サイズ 4 GB、圧縮サイズ 4 GB、総サイズ 4 GB、ファイル数 65 535 という制限があります。ZIP64 形式拡張により、これらの制限が 2⁶⁴ に引き上げられます。

IPptxOptions.Zip64Mode プロパティを使用すると、Office Open XML ファイルを保存する際に ZIP64 形式拡張を使用するタイミングを選択できます。

このプロパティは次のモードを提供します。

IfNecessary は、プレゼンテーションが上記制限を超える場合にのみ ZIP64 形式拡張を使用します。既定のモードです。
Never は ZIP64 形式拡張を使用しません。
Always は常に ZIP64 形式拡張を使用します。

以下のコードは、ZIP64 形式拡張を有効にして PPTX としてプレゼンテーションを保存する方法を示しています。

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

NOTE

Zip64Mode.Never で保存すると、プレゼンテーションを ZIP32 形式で保存できない場合に PptxException がスローされます。

サムネイルを更新せずにプレゼンテーションを保存

PptxOptions.RefreshThumbnail プロパティは、PPTX に保存する際のサムネイル生成を制御します。

true に設定すると、保存時にサムネイルが更新されます。既定値です。
false に設定すると、現在のサムネイルが保持されます。プレゼンテーションにサムネイルがない場合は生成されません。

以下のコードは、サムネイルを更新せずに PPTX としてプレゼンテーションを保存する例です。

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

Info

このオプションを使用すると、PPTX 形式での保存にかかる時間を短縮できます。

保存進捗をパーセンテージで取得

IProgressCallback インターフェイスは、ISaveOptions インターフェイスが公開する ProgressCallback プロパティと、抽象クラス SaveOptions を介して使用されます。ProgressCallback に IProgressCallback の実装を割り当てると、保存進捗がパーセンテージで通知されます。

以下のコードスニペットは、IProgressCallback の使用方法を示しています。

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)
    {
        // ここで進捗のパーセンテージ値を使用します。
        int progress = Convert.ToInt32(progressValue);

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

Info

Aspose は、独自 API を利用した無料の PowerPoint 分割アプリ PowerPoint Splitter を提供しています。このアプリを使うと、選択したスライドを新しい PPTX または PPT ファイルとして保存し、プレゼンテーションを複数のファイルに分割できます。

FAQ

「高速保存」（インクリメンタル保存）は、変更分だけを書き込むことがサポートされていますか？

いいえ。保存は毎回完全なターゲットファイルを作成します。インクリメンタルの「高速保存」はサポートされていません。

同じ Presentation インスタンスを複数スレッドから同時に保存することは安全ですか？

いいえ。Presentation インスタンスはスレッドセーフではありません。単一スレッドから保存してください。

保存時にハイパーリンクや外部リンクされたファイルはどうなりますか？

ハイパーリンクは保持されます。外部リンクされたファイル（例: 相対パスで参照された動画）は自動的にコピーされません。参照パスが引き続きアクセス可能であることを確認してください。

文書メタデータ（作者、タイトル、会社、日付）を設定/保存できますか？

はい。標準の文書プロパティがサポートされており、保存時にファイルに書き込まれます。

.NET でプレゼンテーションを複数形式へ変換 .NETでスライドショーを管理する