C#でPowerPointプレゼンテーションのプロパティを管理する

概要

Aspose.Slides for .NET は、組み込み と カスタム の 2 種類のドキュメントプロパティをサポートしています。これらのプロパティは、Aspose.Slides for .NET API を使用して簡単にアクセスおよび管理できます。

ドキュメントプロパティを扱うために、Aspose.Slides は IDocumentProperties インターフェイスを提供しており、Presentation.DocumentProperties プロパティから取得できます。開発者は Presentation オブジェクトの IDocumentProperties インターフェイスを利用して、以下の例に示すようにプレゼンテーションプロパティをシームレスに読み取り、変更、管理できます。

Application と Producer のフィールドは変更できません。これらのフィールドは常に「Aspose Ltd.」および「Aspose.Slides for .NET x.x.x」と表示されます。

プレゼンテーションプロパティの管理

Microsoft PowerPoint には、プレゼンテーションファイルにプロパティを追加する機能があります。これらのドキュメントプロパティにより、ファイルに有用な情報を保存できます。ドキュメントプロパティには次の 2 種類があります。

システム定義（組み込み）プロパティ
ユーザー定義（カスタム）プロパティ

組み込み プロパティは、文書タイトル、作者名、文書統計情報など、文書に関する一般的な情報を含みます。

カスタム プロパティは、ユーザーが 名前/値 のペアとして定義するもので、名前と値はユーザーが指定します。

Aspose.Slides for .NET を使用すると、開発者は組み込みプロパティとカスタムプロパティの両方にアクセスして変更できます。

Microsoft PowerPoint では、Office アイコンをクリックし、ファイル → 情報 → プロパティ を選択することでドキュメントプロパティを管理できます。詳細プロパティ を選ぶと、プレゼンテーションファイルのすべてのドキュメントプロパティを管理できるダイアログが表示されます。

プロパティ ダイアログには 全般、概要、統計、コンテンツ、カスタム などのタブがあります。各タブは PowerPoint ファイルに関する特定の情報の設定オプションを提供します。カスタム タブはユーザー定義プロパティの管理に使用されます。

組み込みプロパティへのアクセス

IDocumentProperties インターフェイスで公開されているこれらのプロパティには、Creator（作者）、Description、Keywords、Created（作成日）、Modified（変更日）、Printed（最終印刷日）、LastModifiedBy、SharedDoc（ドキュメントが複数のプロデューサー間で共有されているか）、PresentationFormat、Subject、Title などがあります。

// プレゼンテーション ファイルを表す Presentation クラスをインスタンス化します。
using Presentation presentation = new Presentation("AccessBuiltInProperties.pptx");

// Get a reference to the object of type IDocumentProperties associated with the presentation.
IDocumentProperties documentProperties = presentation.DocumentProperties;

// Display the Built-in properties.
Console.WriteLine("Category : " + documentProperties.Category);
Console.WriteLine("Content status : " + documentProperties.ContentStatus);
Console.WriteLine("Creation date : " + documentProperties.CreatedTime);
Console.WriteLine("Author : " + documentProperties.Author);
Console.WriteLine("Comments : " + documentProperties.Comments);
Console.WriteLine("Key words : " + documentProperties.Keywords);
Console.WriteLine("Last modified by : " + documentProperties.LastSavedBy);
Console.WriteLine("Manager : " + documentProperties.Manager);
Console.WriteLine("Modified date : " + documentProperties.LastSavedTime);
Console.WriteLine("Presentation format : " + documentProperties.PresentationFormat);
Console.WriteLine("Last print date : " + documentProperties.LastPrinted);
Console.WriteLine("Is shared between producers : " + documentProperties.SharedDoc);
Console.WriteLine("Subject : " + documentProperties.Subject);
Console.WriteLine("Title : " + documentProperties.Title);

組み込みプロパティの変更

プレゼンテーションファイルの組み込みプロパティの変更は、アクセスと同様に簡単です。任意のプロパティに文字列値を代入すれば、そのプロパティの値が更新されます。以下の例では、プレゼンテーションファイルの組み込みドキュメントプロパティを変更する方法を示します。

// プレゼンテーション ファイルを表す Presentation クラスのインスタンスを作成します。
using Presentation presentation = new Presentation("ModifyBuiltInProperties.pptx");

// プレゼンテーションに関連付けられた IDocumentProperties 型オブジェクトへの参照を取得します。
IDocumentProperties documentProperties = presentation.DocumentProperties;

// 組み込みプロパティを設定します。
documentProperties.Author = "Aspose.Slides for .NET";
documentProperties.Title = "Manage PowerPoint Presentation Properties";
documentProperties.Subject = "Modify Built-in Properties";
documentProperties.Comments = "Aspose description";
documentProperties.Manager = "Aspose manager";

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

カスタムプレゼンテーションプロパティの追加

カスタムプレゼンテーションプロパティを使用すると、開発者はプレゼンテーションファイル内に追加のメタデータや特定の情報を保存できます。Aspose.Slides は、これらのカスタムプロパティをプログラムで作成および管理する機能を提供します。以下の例は、プレゼンテーションにカスタムプロパティを追加する方法を示しています。

// Presentation クラスをインスタンス化します。
using Presentation presentation = new Presentation();

// プレゼンテーションに関連付けられた IDocumentProperties 型オブジェクトへの参照を取得します。
IDocumentProperties documentProperties = presentation.DocumentProperties;

// カスタム プロパティを追加します。
documentProperties["Reviewed by"] = "John Smith";
documentProperties["Confidentiality level"] = "Internal";
documentProperties["Document version"] = 2;

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

カスタムプロパティの取得と変更

Aspose.Slides は、既存のカスタムプロパティにアクセスし、その値を簡単に変更することも可能です。この機能により、正確なメタデータを維持し、ユーザー入力やビジネスロジックに基づく動的な更新がサポートされます。以下の例は、プレゼンテーション内のカスタムプロパティ値を取得および更新する方法を示しています。

// PPTX ファイルを表す Presentation クラスのインスタンスを作成します。
using Presentation presentation = new Presentation("AccessAndModifyProperties.pptx");

// Get a reference to the object of type IDocumentProperties associated with the presentation.
IDocumentProperties documentProperties = presentation.DocumentProperties;

// カスタム プロパティにアクセスして変更します。
for (int i = 0; i < documentProperties.CountOfCustomProperties; i++)
{
    string propertyName = documentProperties.GetCustomPropertyName(i);
    object propertyValue = documentProperties[propertyName];

    // カスタム プロパティの名前と値を表示します。
    Console.WriteLine("Custom property name : " + propertyName);
    Console.WriteLine("Custom property value : " + propertyValue);

    // カスタム プロパティの値を変更します。
    documentProperties[propertyName] = "New Value " + (i + 1);
}

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

ライブ例

Aspose.Slides API を使用したドキュメントプロパティの操作方法を確認するには、オンラインアプリ View & Edit PowerPoint Metadata をお試しください。

*よくある質問

組み込みプロパティをプレゼンテーションから削除するにはどうすればよいですか？

組み込みプロパティはプレゼンテーションの不可欠な部分であり、完全に削除することはできません。ただし、許可されているプロパティであれば、値を変更したり空文字列に設定したりできます。

既に存在するカスタムプロパティを追加した場合、どうなりますか？

既に存在するカスタムプロパティを追加すると、既存の値は新しい値で上書きされます。事前に削除やチェックを行う必要はなく、Aspose.Slides が自動的にプロパティの値を更新します。

プレゼンテーション全体をロードせずにプロパティにアクセスできますか？

はい、可能です。PresentationFactory クラスの GetPresentationInfo メソッドを使用し、取得した IPresentationInfo インターフェイスの ReadDocumentProperties メソッドでプロパティを効率的に読み取ることで、メモリ使用量を抑え、パフォーマンスを向上させることができます。

プレゼンテーションセキュリティ .NET でプレゼンテーションのビュープロパティを取得および更新する