.NET でプレゼンテーションプロパティを管理する

このページの概要

Aspose.Slides for .NET でプレゼンテーションプロパティをマスターし、PowerPoint および OpenDocument ファイルの検索、ブランディング、ワークフローを効率化します。

概要

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

Aspose.Slides は、IDocumentProperties インターフェイスを介してプレゼンテーションドキュメントプロパティにアクセスできます。このインターフェイスのインスタンスは、IPresentation.DocumentProperties によって返されます。以下の例では、これらのプロパティの読み取り、変更、管理方法を示します。

Note

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

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

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

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

組み込み プロパティは、ドキュメントタイトル、著者名、統計情報など、ドキュメント全般に関する情報を含みます。

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

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

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

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

暗号化されたプレゼンテーションから公開プロパティを読み取る

開封パスワードは通常、プレゼンテーションコンテンツとドキュメントプロパティの両方を保護します。IProtectionManager.EncryptDocumentProperties が false に設定された状態で暗号化されたプレゼンテーションでは、ドキュメントプロパティは公開されたままです。アプリケーションは LoadOptions.OnlyLoadDocumentProperties を true に設定して、開封パスワードを提供せずに公開メタデータを読み取れます。

OnlyLoadDocumentProperties は Aspose.Slides が読み込む対象を制御するものであり、復号は行いません。プロパティが暗号化に含まれている場合、パスワードなしでの読み込みは失敗します。プレゼンテーションが暗号化されていない場合、このオプションは無視され、プレゼンテーション全体が読み込まれます。

以下の例は、IProtectionManager.IsOnlyDocumentPropertiesLoaded で読み込みモードを確認し、IPresentation.DocumentProperties を介して組み込みプロパティを読み取ります。

using System;
using Aspose.Slides;

var loadOptions = new LoadOptions { OnlyLoadDocumentProperties = true };
using var presentation = new Presentation("public-properties-encrypted.pptx", loadOptions);

if (presentation.ProtectionManager.IsOnlyDocumentPropertiesLoaded)
{
    var properties = presentation.DocumentProperties;

    Console.WriteLine("Author: " + properties.Author);
    Console.WriteLine("Title: " + properties.Title);
    Console.WriteLine("Keywords: " + properties.Keywords);
}
else
{
    Console.WriteLine("The presentation was not loaded in document-properties-only mode.");
}

このモードではスライドコンテンツは読み込まれません。スライド、マスター、レイアウト、シェイプ、メディア、その他のプレゼンテーションオブジェクトは利用できません。アプリケーションは、プレゼンテーション全体のオブジェクトモデルが必要な操作を実行する前に必ず IsOnlyDocumentPropertiesLoaded をチェックすべきです。

Security

公開メタデータには、著者名、タイトル、サブジェクト、キーワード、会社情報、コメント、カスタム値が含まれる可能性があります。機密プロパティはプレゼンテーションとともに暗号化してください。インデックス作成、分類、検索、または文書管理システムがパスワードなしでのアクセスを特別に要求する場合にのみ、公開のままにしてください。

暗号化されたプレゼンテーションのプロパティを更新する

暗号化された PPTX ファイルの場合、OnlyLoadDocumentProperties で読み込まれたプレゼンテーションは公開メタデータの読み取り専用です。Aspose.Slides は、そのメタデータ専用オブジェクトから変更されたプロパティを保存できません。公開プロパティは暗号化されたプレゼンテーション内の対応データと整合性を保つ必要があるため、正しい開封パスワードで完全にロードしてから更新する必要があります。

以下の例は、LoadOptions.Password でプレゼンテーションを開き、公開の組み込みプロパティを更新して結果を保存します。その後、IPresentationInfo.IsEncrypted を使用して暗号化が保持されていることを確認し、パスワードなしで公開メタデータを再度開いて新しい値を検証します。

using System;
using Aspose.Slides;
using Aspose.Slides.Export;

const string inputPath = "public-properties-encrypted.pptx";
const string outputPath = "updated-public-properties-encrypted.pptx";

{
    var loadOptions = new LoadOptions { Password = "open_password" };
    using var presentation = new Presentation(inputPath, loadOptions);

    presentation.DocumentProperties.Title = "Updated Product Roadmap";
    presentation.DocumentProperties.Keywords = "roadmap, planning, indexed";
    presentation.Save(outputPath, SaveFormat.Pptx);
}

var presentationInfo = PresentationFactory.Instance.GetPresentationInfo(outputPath);
Console.WriteLine("The presentation is encrypted: " + presentationInfo.IsEncrypted);

var metadataLoadOptions = new LoadOptions { OnlyLoadDocumentProperties = true };
using var metadataPresentation = new Presentation(outputPath, metadataLoadOptions);

if (metadataPresentation.ProtectionManager.IsOnlyDocumentPropertiesLoaded)
{
    Console.WriteLine("Title: " + metadataPresentation.DocumentProperties.Title);
    Console.WriteLine("Keywords: " + metadataPresentation.DocumentProperties.Keywords);
}
else
{
    Console.WriteLine("The presentation was not loaded in document-properties-only mode.");
}

アプリケーションがプレゼンテーションコンテンツの復号またはロードを許可されていない場合、暗号化された PPTX ファイルの公開プロパティは読み取り専用として扱う必要があります。

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

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

using Aspose.Slides;

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

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

// 組み込みプロパティを表示します。
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);

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

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

using Aspose.Slides;
using Aspose.Slides.Export;

// プレゼンテーション ファイルを表す 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 は、これらのカスタムプロパティをプログラムで簡単に作成および管理できるようにします。以下の例は、プレゼンテーションにカスタムプロパティを追加する方法を示します。

using Aspose.Slides;
using Aspose.Slides.Export;

// 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 は、既存のカスタムプロパティにアクセスし、その値を簡単に変更できる機能も提供します。この機能により、正確なメタデータを維持し、ユーザー入力やビジネスロジックに基づく動的な更新が可能になります。以下の例は、プレゼンテーション内のカスタムプロパティ値を取得および更新する方法を示します。

using Aspose.Slides;
using Aspose.Slides.Export;

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

// プレゼンテーションに関連付けられた IDocumentProperties 型オブジェクトへの参照を取得します。
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);

ライブ例

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

FAQ

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

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

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

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

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

はい。PresentationFactory.GetPresentationInfo を使用し、続いて IPresentationInfo.ReadDocumentProperties を呼び出すことで、Presentation インスタンスを作成せずに保存されたドキュメントメタデータを読み取れます。完全なレポート例とフォーマット別の制限については、Build a Lightweight Presentation Inventory を参照してください。

開封パスワードなしで暗号化されたプレゼンテーションの公開プロパティを読み取れますか？

はい。プレゼンテーションが EncryptDocumentProperties を false に設定した状態で暗号化され、OnlyLoadDocumentProperties を true にしてロードされている必要があります。

ドキュメントプロパティのみのモードで暗号化された PPTX ファイルを更新できますか？

いいえ。公開プロパティと暗号化されたプロパティデータは整合性を保つ必要があるため、暗号化された PPTX ファイルを更新するには正しい開封パスワードでプレゼンテーション全体をロードする必要があります。

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

.NET でプレゼンテーション プロパティを管理する