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

導入

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

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

組み込みプロパティとカスタムプロパティについて知っておくべき最も重要な点は、組み込みプロパティはアクセスして変更することはできますが、作成したり削除したりすることはできないということです。ただし、カスタムプロパティを作成および管理することはできます。

Microsoft Excel を使用してドキュメントのプロパティを管理する方法

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

からファイルメニューで、*情報**を選択します。

情報メニューの選択

クリックプロパティ見出しをクリックして「詳細プロパティ」を選択します。

「詳細プロパティの選択」をクリックする

ファイルのドキュメントプロパティを管理します。

プロパティダイアログ

「プロパティ」ダイアログには、「一般」、「概要」、「統計」、「コンテンツ」、「カスタム」などのさまざまなタブがあります。各タブは、ファイルに関連するさまざまな種類の情報を構成するのに役立ちます。 [カスタム] タブは、カスタムプロパティを管理するために使用されます。

Aspose.Cells を使用してドキュメントのプロパティを操作する方法

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

Aspose.Cells for .NET は、API とバージョン番号に関する情報を出力ドキュメントに直接書き込みます。たとえば、Document を PDF にレンダリングすると、Aspose.Cells for .NET が設定されます。応用値「Aspose.Cells」を持つフィールドとPDF プロデューサーフィールドに値を入力します（例：「Aspose.Cells v17.9」）。

Aspose.Cells for .NET に対して、出力ドキュメントからこの情報を変更または削除するように指示することはできないことに注意してください。

ドキュメントのプロパティにアクセスする方法

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

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

組み込みのドキュメントプロパティにアクセスするには、次を使用します。WorksheetCollection.BuiltInDocumentProperties.
カスタムドキュメントプロパティにアクセスするには、次を使用します。WorksheetCollection.CustomDocumentProperties.

どちらもWorksheetCollection.BuiltInDocumentPropertiesそしてWorksheetCollection.CustomDocumentPropertiesのインスタンスを返しますAspose.Cells.Properties.DocumentPropertyCollection。このコレクションには以下が含まれますAspose.Cells.Properties.DocumentPropertyオブジェクト。それぞれが単一の組み込みまたはカスタムのドキュメントプロパティを表します。

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

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

プロパティ名を取得するには、次を使用します。ドキュメントプロパティ名.
プロパティ値を取得するには、次を使用します。DocumentProperty.Value. DocumentProperty.Value値をオブジェクトとして返します。
プロパティのタイプを取得するには、次を使用します。DocumentProperty.Type 。これは、次のいずれかを返します。プロパティタイプ列挙値。プロパティタイプを取得したら、次のいずれかを使用します。DocumentProperty.ToXXXを使用する代わりに適切な型の値を取得するメソッドDocumentProperty.Value。のDocumentProperty.ToXXX方法については、以下の表で説明します。

のドキュメントプロパティクラスは、他のデータ型の値を返す一連のメソッドも提供します。

メンバー名	説明	ToXXXメソッド
ブール値	プロパティのデータ型はブール型です	トブール
日付	プロパティのデータ型は DateTime です。 Microsoft Excel ストアのみに注意してください日付部分、このタイプのカスタムプロパティには時間を保存できません	終了日時
浮く	プロパティのデータ型は Double です	ダブルに
番号	プロパティのデータ型は Int32 です	ToInt
String	プロパティのデータ型は文字列です	ToString

カスタムドキュメントプロパティを追加または削除する方法

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

カスタムプロパティを追加する方法

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

「コンテンツへのリンク」カスタムプロパティを設定する方法

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

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

カスタムプロパティを削除する方法

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

アドバンストトピック

ワークブックの印刷とプレビュー Microsoft Excel ファイルのワークシートを管理します。