導入

ようこそ！Aspose.Words for .NET をご利用中で、Word ファイルにカスタムドキュメントプロパティを追加する方法を知りたい方は、ぜひこのチュートリアルをご覧ください。カスタムプロパティは、組み込みプロパティではカバーされない追加のメタデータを保存する際に非常に役立ちます。ドキュメントの承認、リビジョン番号、特定の日付などを追跡する必要がある場合でも、カスタムプロパティは役立ちます。このチュートリアルでは、Aspose.Words for .NET を使用してこれらのプロパティをシームレスに追加する手順を解説します。さあ、始めましょう！

前提条件

コードに進む前に、次のものを用意してください。

Aspose.Words for .NET ライブラリ: ダウンロードここ.
開発環境: Visual Studio などの IDE。
C# の基礎知識: C# と .NET の知識があると役立ちます。
サンプル文書:サンプルのWord文書を準備します。 Properties.docx 変更のため。

名前空間のインポート

Aspose.Words の機能にアクセスするには、コードの先頭に必要な名前空間をインポートする必要があります。

using System;
using Aspose.Words;

ステップ1: ドキュメントパスの設定

次に、Word文書へのパスを定義しましょう。この手順は、Word文書を見つけて開くために不可欠です。 Properties.docx ファイル。

// ドキュメント ディレクトリへのパスを指定します。
string dataDir = "YOUR DOCUMENT DIRECTORY";
Document doc = new Document(dataDir + "Properties.docx");

必ず交換してください "YOUR DOCUMENT DIRECTORY" ドキュメントへの実際のパスを入力します。

ステップ2: カスタムドキュメントプロパティにアクセスする

ここで、カスタムメタデータが保存される Word 文書のカスタムドキュメントプロパティにアクセスしてみましょう。

CustomDocumentProperties customDocumentProperties = doc.CustomDocumentProperties;

この行により、操作するカスタムプロパティのコレクションにアクセスできます。

ステップ3: 既存のプロパティを確認する

新しいプロパティを追加する前に、重複を避けるために、プロパティが既に存在するかどうかを確認することをお勧めします。

if (customDocumentProperties["Authorized"] != null) return;

このコードは、「Authorized」プロパティが既に存在するかどうかを確認します。存在する場合、メソッドは早期に終了し、重複を防止します。

ステップ4: ブールプロパティの追加

ドキュメントが承認されているかどうかを示すカスタムブールプロパティを追加しましょう。

customDocumentProperties.Add("Authorized", true);

この行は「Authorized」というプロパティを追加し、その値を true。

ステップ5: 文字列プロパティの追加

次に、文字列プロパティを追加して、ドキュメントを承認したユーザーを指定します。

customDocumentProperties.Add("Authorized By", "John Smith");

「John Smith」を好きな名前に置き換えてください。

ステップ6: 日付プロパティの追加

ドキュメントがいつ承認されたかを追跡するには、日付プロパティを追加しましょう。

customDocumentProperties.Add("Authorized Date", DateTime.Today);

この行は「承認日」というプロパティを追加し、今日の日付を割り当てます。 DateTime。Today.

ステップ7: リビジョン番号の追加

バージョン管理のために、ドキュメントのリビジョン番号を追跡するためのプロパティを追加できます。

customDocumentProperties.Add("Authorized Revision", doc.BuiltInDocumentProperties.RevisionNumber);

ここでは、ドキュメントの現在のリビジョン番号を保持する「承認済みリビジョン」プロパティを追加します。

ステップ8: 数値プロパティの追加

最後に、予算額などの承認金額を格納するための数値プロパティを追加しましょう。

customDocumentProperties.Add("Authorized Amount", 123.45);

この行は、「承認金額」という名前のプロパティを次の値で追加します。 123.45必要に応じてこの数値を調整できます。

結論

おめでとうございます！Aspose.Words for .NET を使用して、Word 文書にカスタムドキュメントプロパティを追加できました。これらのプロパティは、承認の詳細、リビジョン番号、特定の数量など、要件に合わせてカスタマイズされたメタデータを保存するための強力な手段です。

よくある質問

カスタムドキュメントプロパティとは何ですか?

カスタムドキュメントプロパティは、組み込みプロパティでカバーされていない追加情報を保存するために Word ドキュメントに追加できるメタデータです。

文字列や数値以外のプロパティを追加できますか?

はい、ブール値、日付、さらにはカスタムオブジェクトなど、さまざまな種類のプロパティを追加できます。

Word 文書でこれらのプロパティにアクセスするにはどうすればよいでしょうか?

Aspose.Words を使用してプログラムでカスタムプロパティにアクセスしたり、ドキュメントプロパティを通じて Word で直接表示したりすることができます。

カスタムプロパティを編集または削除することは可能ですか?

もちろんです！Aspose.Words が提供するメソッドを使用して、カスタムプロパティを簡単に編集または削除できます。

ドキュメントのフィルタリングにカスタムプロパティを使用できますか?

はい！カスタムプロパティは、特定のメタデータに基づいてドキュメントを分類およびフィルタリングするのに最適です。

導入