.NET でプレゼンテーション情報の取得と更新

このページの概要

.NET を使用して PowerPoint および OpenDocument プレゼンテーションのスライド、構造、メタデータを調査し、迅速な洞察と賢いコンテンツ監査を実現します。

概要

Aspose.Slides は、プレゼンテーションの形式を識別し、完全なプレゼンテーションオブジェクトモデルを作成せずにドキュメントメタデータを読み取ることができます。これは、ファイルを分類したり、インベントリを作成したり、プレゼンテーションのコンテンツをロードして処理するかどうかを判断する前にプロパティを検査したりする場合に便利です。

この記事では、PresentationFactory と IPresentationInfo を使用した軽量検査と、IDocumentProperties を使用した対象となる更新を示します。

プレゼンテーション形式の確認

ロード済みのプレゼンテーションがある場合は、ロード後の検出およびレガシー PPT、PPS、POT ストリームの制限については、Determine the Original Presentation Format を参照してください。

PresentationFactory.GetPresentationInfo を使用して、Presentation インスタンスを作成せずにファイルを検査します。IPresentationInfo.LoadFormat プロパティは、PPTX、PPT、ODP など検出された形式を報告します。

using System;
using Aspose.Slides;

var fileNames = new[] { "pres.pptx", "pres.ppt", "pres.odp" };

foreach (var fileName in fileNames)
{
    var presentationInfo = PresentationFactory.Instance.GetPresentationInfo(fileName);
    Console.WriteLine($"{fileName}: {presentationInfo.LoadFormat}");
}

軽量プレゼンテーションインベントリの構築

多数のプレゼンテーションファイルを処理する場合、検証やインデックス作成、ドキュメント管理システムのためにコンパクトなインベントリが必要になることがあります。このシナリオでは、PresentationFactory.GetPresentationInfo を使用して IPresentationInfo オブジェクトを取得し、次に IPresentationInfo.ReadDocumentProperties を呼び出してドキュメントメタデータを読み取ります。この方法では、Presentation インスタンスを作成したり、完全なプレゼンテーションオブジェクトモデルを走査したりする必要はありません。

IDocumentProperties が提供する拡張プロパティは、以下のインベントリ値を提供します。

プロパティ	インベントリ値
Slides	スライドの総数。
HiddenSlides	非表示スライドの数。
Notes	ノートが含まれるスライドの数。
Paragraphs	利用可能な場合の段落の総数。
Words	単語の総数。
MultimediaClips	オーディオおよびビデオクリップの総数。

以下の例は、これらの値を Presentation オブジェクトを作成せずに読み取り、コンパクトなインベントリを出力します。また、HeadingPairs と TitlesOfParts を組み合わせて、フォント、テーマ、スライドタイトルなどのコンテンツグループを表示します。

using System;
using System.IO;
using Aspose.Slides;

var filePath = "sample.pptx";
var presentationInfo = PresentationFactory.Instance.GetPresentationInfo(filePath);
var documentProperties = presentationInfo.ReadDocumentProperties();

Console.WriteLine($"File: {Path.GetFileName(filePath)}");
Console.WriteLine($"Format: {presentationInfo.LoadFormat}");
Console.WriteLine($"Title: {documentProperties.Title}");
Console.WriteLine($"Author: {documentProperties.Author}");
Console.WriteLine("Statistics:");
Console.WriteLine($"  Slides: {documentProperties.Slides}");
Console.WriteLine($"  Hidden slides: {documentProperties.HiddenSlides}");
Console.WriteLine($"  Slides with notes: {documentProperties.Notes}");
Console.WriteLine($"  Paragraphs: {documentProperties.Paragraphs}");
Console.WriteLine($"  Words: {documentProperties.Words}");
Console.WriteLine($"  Multimedia clips: {documentProperties.MultimediaClips}");

var headingPairs = documentProperties.HeadingPairs ?? Array.Empty<IHeadingPair>();
var titlesOfParts = documentProperties.TitlesOfParts ?? Array.Empty<string>();
var partIndex = 0;

if (headingPairs.Length == 0 || titlesOfParts.Length == 0)
{
    Console.WriteLine("Content groups: not available");
}
else
{
    Console.WriteLine("Content groups:");

    foreach (var headingPair in headingPairs)
    {
        Console.WriteLine($"  {headingPair.Name} ({headingPair.Count})");

        for (var partOffset = 0; partOffset < headingPair.Count && partIndex < titlesOfParts.Length; partOffset++)
        {
            Console.WriteLine($"    - {titlesOfParts[partIndex]}");
            partIndex++;
        }
    }

    if (partIndex < titlesOfParts.Length)
    {
        Console.WriteLine("  Other parts:");

        while (partIndex < titlesOfParts.Length)
        {
            Console.WriteLine($"    - {titlesOfParts[partIndex]}");
            partIndex++;
        }
    }
}

各 IHeadingPair はグループ名とそのグループ内の項目数を提供します。IDocumentProperties.TitlesOfParts はフラットで順序付きの配列であるため、各見出しペアで指定された連続タイトル数を消費します。

保存されたメタデータと形式の制限

IPresentationInfo.ReadDocumentProperties が返すインベントリプロパティは、ソースドキュメントに存在するメタデータを反映しています。Aspose.Slides はこの呼び出しのためにプレゼンテーションオブジェクトモデルをロードして走査し、それらの値を再計算しません。欠落しているプロパティはデフォルト値で表され、保存時にアプリケーションがドキュメントプロパティを更新しなかった場合、保存された値は古くなる可能性があります。

PPTX: スライド、ノート、非表示スライド、段落、単語、マルチメディアのカウントに加えて、見出しペアとパートタイトルの拡張ドキュメントプロパティが提供されます。利用可能性は、ドキュメント作成者がどのプロパティを書き込んだかに依存します。
PPT: バイナリ形式は対応するドキュメントサマリプロパティを格納できます。プロパティが存在しないか作成者によって更新されていない場合、Aspose.Slides はスライドから計算するのではなく、格納された値またはデフォルト値を返します。
ODP: OpenDocument メタデータはページ、段落、単語のカウントなど一般的な統計情報を提供しますが、これらの値はすべての PowerPoint 固有の拡張プロパティにマッピングされるわけではありません。非表示スライド、ノートスライド、マルチメディア、見出しペア、パートタイトルのメタデータは利用できないことがあり、インベントリプロパティはデフォルト値を返す場合があります。ゼロ値や空配列が存在すると必ずしも該当コンテンツが不存在であることを意味しません。

インベントリや事前チェックには軽量メタデータアプローチを使用してください。結果がメモリ内の変更を反映する必要がある場合や、実際のプレゼンテーションコンテンツを検証する必要がある場合は、プレゼンテーションをロードしてライブオブジェクトモデルを検査してください。

プレゼンテーションプロパティの更新

IPresentationInfo.ReadDocumentProperties が返すプロパティは、Presentation インスタンスを作成せずに変更することも可能です。IPresentationInfo.UpdateDocumentProperties で変更を適用し、続いて IPresentationInfo.WriteBindedPresentation でバインドされたプレゼンテーションを書き込みます。

以下の画像は元のドキュメントプロパティを示しています。

PowerPoint プレゼンテーションの元のドキュメントプロパティ

以下の例はタイトルと最終保存時刻を変更し、結果を新しいファイルに書き込みます：

using System;
using System.IO;
using Aspose.Slides;

var sourceFile = "sample.pptx";
var outputFile = "sample_with_updated_properties.pptx";
var presentationInfo = PresentationFactory.Instance.GetPresentationInfo(sourceFile);
var documentProperties = presentationInfo.ReadDocumentProperties();

documentProperties.Title = "Quarterly sales report";
documentProperties.LastSavedTime = DateTime.UtcNow;

presentationInfo.UpdateDocumentProperties(documentProperties);
using var outputStream = File.Create(outputFile);
presentationInfo.WriteBindedPresentation(outputStream);

以下の画像は変更されたドキュメントプロパティを示しています。

PowerPoint プレゼンテーションの変更されたドキュメントプロパティ

有用なリンク

関連するセキュリティチェックや保護設定については、以下の記事を参照してください。

FAQ

フォントが埋め込まれているか、どのフォントが埋め込まれているかをどうやって確認できますか？

プレゼンテーションをロードし、Presentation.FontsManager を使用します。FontsManager.GetEmbeddedFonts で埋め込まれたフォントを取得し、FontsManager.GetFonts でプレゼンテーションで使用されているフォントを取得します。両方の結果を比較して、レンダリングに必要だが埋め込まれていないフォントを特定します。

ファイルに非表示スライドがあるかどうか、またその数を素早く判断する方法はありますか？

保存されたドキュメントメタデータが十分である場合、PresentationFactory.GetPresentationInfo と IPresentationInfo.ReadDocumentProperties を介して IDocumentProperties.HiddenSlides を読み取ります。これは軽量インベントリに適しています。メモリ上でプレゼンテーションが変更されている可能性がある場合や、最新の値を確認したい場合は、Presentation.Slides を走査し、各スライドの Slide.Hidden プロパティを確認してください。

カスタムスライドサイズと方向が使用されているか、既定値と異なるかを検出できますか？

はい。プレゼンテーションをロードし、Presentation.SlideSize を読み取ります。ISlideSize.Type、ISlideSize.Size、ISlideSize.Orientation を確認し、現在の設定が期待されるプリセットや寸法と一致しているか比較します。

チャートが外部データソースを参照しているかどうかを素早く確認する方法はありますか？

はい。各 Chart を特定し、ChartData.DataSourceType を検査します。外部ブックの場合は、ChartData.ExternalWorkbookPath を読み取ります。データソースタイプとパスが外部参照を示しますが、対象が実際に利用可能かどうかは別途リソースチェックが必要です。

レンダリングや PDF エクスポートを遅くする可能性のある「重い」スライドを評価する簡単な方法はありますか？

単一の複雑度プロパティは存在しません。Presentation.Slides と各スライドの IBaseSlide.Shapes コレクションを走査します。シェイプ数や大容量画像、エフェクト、アニメーション、マルチメディアの有無をスクリーニング信号として使用し、代表的なレンダリングまたはエクスポートの測定を行った上で、スライドを実際のパフォーマンスボトルネックとして確定させます。

.NET でプレゼンテーションを開く .NET で元のプレゼンテーション形式を判定する