ドキュメント プロパティの管理

序章

Microsoft Excel には、スプレッドシート ファイルにプロパティを追加する機能があります。これらのドキュメント プロパティは有用な情報を提供し、以下に詳述するように 2 つのカテゴリに分けられます。

  • システム定義 (組み込み) プロパティ: 組み込みプロパティには、ドキュメントのタイトル、作成者名、ドキュメントの統計など、ドキュメントに関する一般的な情報が含まれています。
  • ユーザー定義 (カスタム) プロパティ: 名前と値のペアの形式でエンド ユーザーによって定義されたカスタム プロパティ。

Microsoft Excel を使用したドキュメント プロパティの管理

Microsoft Excel では、Excel ファイルのドキュメント プロパティを WYSIWYG 方式で管理できます。以下の手順に従って、プロパティ Excel 2016 のダイアログ。

  1. からファイルメニュー、選択情報.
情報メニューの選択
todo:画像_代替_文章
  1. クリックプロパティ見出しを開き、[詳細プロパティ] を選択します。
詳細プロパティの選択をクリックする
todo:画像_代替_文章
  1. ファイルのドキュメント プロパティを管理します。
プロパティダイアログ
todo:画像_代替_文章
[プロパティ] ダイアログには、[全般]、[概要]、[統計]、[コンテンツ]、[税関] などのさまざまなタブがあります。各タブは、ファイルに関連するさまざまな種類の情報を構成するのに役立ちます。 [カスタム] タブは、カスタム プロパティを管理するために使用されます。

Aspose.Cells を使用したドキュメント プロパティの操作

開発者は、Aspose.Cells API を使用してドキュメント プロパティを動的に管理できます。この機能は、開発者がファイルの受信、処理、タイムスタンプなどの有用な情報をファイルとともに保存するのに役立ちます。

ドキュメント プロパティへのアクセス

Aspose.Cells API は、組み込みとカスタムの両方のタイプのドキュメント プロパティをサポートします。 Aspose.Cells'ワークブッククラスは Excel ファイルを表し、Excel ファイルと同様に、ワークブッククラスには複数のワークシートを含めることができ、それぞれがワークシートクラスで表されますが、ワークシートのコレクションはワークシート コレクションクラス。

使用ワークシート コレクション以下で説明するように、ファイルのドキュメント プロパティにアクセスします。

両方のWorksheetCollection.BuiltInDocumentPropertiesWorksheetCollection.CustomDocumentPropertiesのインスタンスを返しますAspose.Cells.Properties.DocumentPropertyCollection.このコレクションにはAspose.Cells.Properties.DocumentProperty各オブジェクトは、単一の組み込みまたはカスタム ドキュメント プロパティを表します。

プロパティにアクセスする方法は、アプリケーションの要件次第です。のプロパティのインデックスまたは名前を使用してドキュメント プロパティ コレクション以下の例に示すように。

Aspose.Cells.Properties.DocumentPropertyクラスを使用すると、ドキュメント プロパティの名前、値、およびタイプを取得できます。

  • プロパティ名を取得するには、次を使用しますDocumentProperty.Name.
  • プロパティ値を取得するには、次を使用しますDocumentProperty.Value. DocumentProperty.Value値をオブジェクトとして返します。
  • プロパティ タイプを取得するには、次を使用します。DocumentProperty.Type .これは、プロパティタイプ列挙値。プロパティ タイプを取得したら、次のいずれかを使用します。DocumentProperty.ToXXXを使用する代わりに、適切な型の値を取得するメソッドDocumentProperty.Value.のDocumentProperty.ToXXXメソッドについては、次の表で説明します。
メンバー名 説明 ToXXX メソッド
ブール値 プロパティのデータ型はブール値です ブール
日にち プロパティのデータ型は DateTime です。 Microsoft Excelストアのみ
日付部分。このタイプのカスタム プロパティに時刻を格納することはできません
ToDateTime
浮く プロパティのデータ型は Double です 二重にする
番号 プロパティのデータ型は Int32 です ToInt
プロパティのデータ型は文字列です ToString

カスタム ドキュメント プロパティの追加または削除

このトピックの冒頭で説明したように、これらのプロパティはシステム定義であるため、開発者は組み込みプロパティを追加または削除できませんが、カスタム プロパティはユーザー定義であるため、追加または削除することができます。

カスタム プロパティの追加

Aspose.Cells API が追加の方法CustomDocumentPropertyCollectionコレクションにカスタム プロパティを追加するためのクラス。の追加メソッドはプロパティを Excel ファイルに追加し、新しいドキュメント プロパティの参照をAspose.Cells.Properties.DocumentProperty物体。

「コンテンツへのリンク」カスタム プロパティの構成

特定の範囲のコンテンツにリンクされたカスタム プロパティを作成するには、CustomDocumentPropertyCollection.AddLinkToContentメソッドとパスのプロパティ名とソース。を使用して、プロパティがコンテンツにリンクされているように構成されているかどうかを確認できます。DocumentProperty.IsLinkedToContent財産。さらに、以下を使用してソース範囲を取得することもできます。ソースのプロパティドキュメント プロパティクラス。

この例では、単純なテンプレート Microsoft Excel ファイルを使用します。ワークブックには、ラベルが付けられた定義済みの名前付き範囲がありますマイレンジこれはセル値を参照します。

カスタム プロパティの削除

Aspose.Cells を使用してカスタム プロパティを削除するには、DocumentPropertyCollection.Removeメソッドを呼び出して、削除するドキュメント プロパティの名前を渡します。

先行トピック