PowerPointファイルのドキュメントプロパティまたはメタデータは、プレゼンテーションの識別に使用されます。さらに、作成者、タイトル、キーワード、件名など、プレゼンテーションに関する追加情報を提供します。この記事では、C#を使用してプログラムでPowerPointファイルのプロパティにアクセスまたは変更する方法を学習します。
- PowerPointファイルのプロパティにアクセス/変更するための.NET API
- PowerPointプレゼンテーションのプロパティの種類
- PowerPointプレゼンテーションの組み込みプロパティにアクセスする
- PowerPointプレゼンテーションの組み込みプロパティを変更する
- PowerPointプレゼンテーションにカスタムプロパティを追加する
- PowerPointプレゼンテーションのカスタムプロパティにアクセスする
- PowerPointプレゼンテーションのカスタムプロパティを変更する
PowerPointファイルのプロパティにアクセス/変更するための.NET API
組み込みまたはカスタムのドキュメントプロパティにアクセスまたは変更するには、Aspose.Slides for .NETを使用します。これは、PowerPointおよびOpenOfficeドキュメントを作成および操作するための強力なAPIです。 APIは、ダウンロード可能なDLLおよびNuGetで利用できます。
PM> Install-Package Aspose.Slides.NET
PowerPointプレゼンテーションのプロパティの種類
PowerPointプレゼンテーションは、組み込みとカスタムの2種類のドキュメントプロパティをサポートしています。組み込みのプロパティは、タイトル、作成者、件名などのプレゼンテーションに関する一般的な情報を提供します。一方、カスタムプロパティは、キーと値のペアの形式でユーザーによって定義されます。次のセクションでは、上記の各タイプに属するプロパティを追加、アクセス、および変更する方法を示します。
C#を使用してPowerPointプレゼンテーションの組み込みプロパティにアクセスする
以下は、C#を使用してPowerPointプレゼンテーションの組み込みプロパティにアクセスするための手順です。
- Presentationクラスを使用してPowerPointプレゼンテーションをロードします。
- Presentation.DocumentPropertiesプロパティからIDocumentPropertiesオブジェクトの組み込みプロパティにアクセスします。
- IDocumentProperties.AuthorなどのIDocumentPropertiesオブジェクトを使用して、プレゼンテーションの各組み込みプロパティを読み取ります。
次のコードサンプルは、PowerPointプレゼンテーションの組み込みプロパティにアクセスする方法を示しています。
// プレゼンテーションを読み込む
Presentation pres = new Presentation("AccessBuiltin Properties.pptx");
// プレゼンテーションに関連付けられたIDocumentPropertiesオブジェクトへの参照を作成します
IDocumentProperties documentProperties = pres.DocumentProperties;
// 組み込みのプロパティを表示する
System.Console.WriteLine("Category : " + documentProperties.Category);
System.Console.WriteLine("Current Status : " + documentProperties.ContentStatus);
System.Console.WriteLine("Creation Date : " + documentProperties.CreatedTime);
System.Console.WriteLine("Author : " + documentProperties.Author);
System.Console.WriteLine("Description : " + documentProperties.Comments);
System.Console.WriteLine("KeyWords : " + documentProperties.Keywords);
System.Console.WriteLine("Last Modified By : " + documentProperties.LastSavedBy);
System.Console.WriteLine("Supervisor : " + documentProperties.Manager);
System.Console.WriteLine("Modified Date : " + documentProperties.LastSavedTime);
System.Console.WriteLine("Presentation Format : " + documentProperties.PresentationFormat);
System.Console.WriteLine("Last Print Date : " + documentProperties.LastPrinted);
System.Console.WriteLine("Is Shared between producers : " + documentProperties.SharedDoc);
System.Console.WriteLine("Subject : " + documentProperties.Subject);
System.Console.WriteLine("Title : " + documentProperties.Title);
C#を使用してPowerPointプレゼンテーションの組み込みプロパティを変更する
以下は、C#を使用してPowerPointプレゼンテーションの組み込みプロパティの値を変更する手順です。
- まず、Presentationクラスを使用してPowerPointプレゼンテーションをロードします。
- 次に、Presentation.DocumentPropertiesプロパティからIDocumentPropertiesオブジェクトの組み込みプロパティの参照を取得します。
- IDocumentProperties.AuthorなどのIDocumentPropertiesオブジェクトを使用して、プレゼンテーションの目的の組み込みプロパティを変更します。
- 最後に、Presentation.Save(String, SaveFormat)メソッドを使用してプレゼンテーションを保存します。
次のコードサンプルは、PowerPointプレゼンテーションの組み込みプロパティを変更する方法を示しています。
// プレゼンテーションを読み込む
Presentation presentation = new Presentation("ModifyBuiltinProperties.pptx");
// プレゼンテーションに関連付けられたIDocumentPropertiesオブジェクトへの参照を作成します
IDocumentProperties documentProperties = presentation.DocumentProperties;
// 組み込みのプロパティを設定する
documentProperties.Author = "Aspose.Slides for .NET";
documentProperties.Title = "Modifying Presentation Properties";
documentProperties.Subject = "Aspose Subject";
documentProperties.Comments = "Aspose Description";
documentProperties.Manager = "Aspose Manager";
// プレゼンテーションをファイルに保存します
presentation.Save("DocumentProperties_out.pptx", SaveFormat.Pptx);
C#を使用してPowerPointプレゼンテーションにカスタムプロパティを追加する
以下は、C#を使用してPowerPointプレゼンテーションにカスタムプロパティを追加する手順です。
- まず、Presentationクラスを使用してPowerPointプレゼンテーションをロードします。
- 次に、Presentation.DocumentPropertiesプロパティからIDocumentPropertiesオブジェクトのドキュメントプロパティの参照を取得します。
- キーと値を定義してカスタムプロパティを追加します(例:IDocumentProperties [“Key”] = “Value”)。
- 最後に、Presentation.Save(String, SaveFormat)メソッドを使用してプレゼンテーションを保存します。
次のコードサンプルは、PowerPointプレゼンテーションにカスタムプロパティを追加する方法を示しています。
// プレゼンテーションを読み込む
Presentation presentation = new Presentation("Presentation.pptx");
// ドキュメントプロパティの参照を取得する
IDocumentProperties documentProperties = presentation.DocumentProperties;
// カスタムプロパティを追加する
documentProperties["New Custom"] = 12;
documentProperties["My Name"] = "Mudassir";
documentProperties["Custom"] = 124;
// プレゼンテーションを保存する
presentation.Save("CustomDocumentProperties_out.pptx", SaveFormat.Pptx);
C#を使用してPowerPointプレゼンテーションのカスタムプロパティにアクセスする
次の手順は、C#を使用してPowerPointプレゼンテーションのカスタムプロパティにアクセスする方法を示しています。
- まず、Presentationクラスを使用してPowerPointプレゼンテーションをロードします。
- Presentation.DocumentPropertiesプロパティからIDocumentPropertiesオブジェクトのドキュメントプロパティの参照を取得します。
- ループ内でIDocumentProperties.GetCustomPropertyName(int32 index)メソッドを使用して、各カスタムプロパティにアクセスします。
次のコードサンプルは、PowerPointプレゼンテーションのカスタムプロパティにアクセスする方法を示しています。
// プレゼンテーションを読み込む
Presentation presentation = new Presentation("Presentation.pptx");
// ドキュメントプロパティの参照を取得する
IDocumentProperties documentProperties = presentation.DocumentProperties;
// カスタムプロパティにアクセスする
for (int i = 0; i < documentProperties.CountOfCustomProperties; i++)
{
// カスタムプロパティの名前と値を表示する
System.Console.WriteLine("Custom Property Name : " + documentProperties.GetCustomPropertyName(i));
System.Console.WriteLine("Custom Property Value : " + documentProperties[documentProperties.GetCustomPropertyName(i)]);
}
C#を使用してPowerPointプレゼンテーションのカスタムプロパティを変更する
以下は、PowerPointプレゼンテーションのカスタムプロパティを変更する手順です。
- まず、Presentationクラスを使用してPowerPointプレゼンテーションをロードします。
- 次に、Presentation.DocumentPropertiesプロパティからIDocumentPropertiesオブジェクトのドキュメントプロパティの参照を取得します。
- ループ内でIDocumentProperties.GetCustomPropertyName(int32 index)メソッドを使用して、各カスタムプロパティにアクセスします。
- IDocumentProperties [IDocumentProperties.GetCustomPropertyName(int index)]配列でキーを指定して、プロパティの値を変更します。
- 最後に、Presentation.Save(String, SaveFormat)メソッドを使用してプレゼンテーションを保存します。
次のコードサンプルは、PowerPointプレゼンテーションのカスタムプロパティを変更する方法を示しています。
// プレゼンテーションを読み込む
Presentation presentation = new Presentation("Presentation.pptx");
// ドキュメントプロパティの参照を取得する
IDocumentProperties documentProperties = presentation.DocumentProperties;
// カスタムプロパティへのアクセスと変更
for (int i = 0; i < documentProperties.CountOfCustomProperties; i++)
{
// カスタムプロパティの値を変更する
documentProperties[documentProperties.GetCustomPropertyName(i)] = "New Value " + (i + 1);
}
// プレゼンテーションを保存する
presentation.Save("CustomDocumentProperties_out.pptx", SaveFormat.Pptx);
無料のAPIライセンスを取得する
一時ライセンスをリクエストすることで、評価の制限なしにAspose.Slides for .NETを使用できます。
オンラインデモ
オンラインツールを試して、Aspose.Slidesに基づくプレゼンテーションのドキュメントプロパティを表示および編集することもできます。
Aspose無料のオンラインPowerPointエディターも試してみてください。
結論
この記事では、C#を使用してPowerPointプレゼンテーションのドキュメントプロパティを追加、アクセス、および変更する方法を学習しました。この記事では、組み込みおよびカスタムのドキュメントプロパティの操作について明示的に説明しました。さらに、ドキュメントにアクセスして、Aspose.Slides for .NETの詳細を確認できます。また、フォーラムにクエリを投稿することもできます。