C#とVB.NETでWord文書にカスタムプロパティを設定する方法

はじめに

文書のプロパティは、文書の特徴や属性を記述および識別するためのメタデータであり、通常、一般的なプロパティとカスタムプロパティに分類されます。この機能は、文書の管理と使用において重要な役割を果たします。一般的なプロパティに加えて、ユーザーは必要に応じてカスタムプロパティやタグを追加することもでき、文書の柔軟な管理と整理、作業効率の向上が可能です。以下では、Wordにカスタムプロパティを設定するためのプログラミング方法について説明します。

ツール

• Visual Studio 2022
• Free Spire.Doc for .NET

準備

1. Free Spire.Doc for .NETをダウンロードします。
2. Visual Studioで新しいプロジェクトを作成します。
3. そのプロジェクトを開いた後、「Solution Explorer」>「References」>「Add Reference」>「Browse」を選択します。
4. BINフォルダ内のDLLファイルを見つけて、「OK」をクリックします。

上記の手順で DLL ファイルをプロジェクトに簡単にインポートできます。

コード

C#:

using Spire.Doc;
using System;

namespace AddCustomDocumentProperties
{
    class Program
    {
        static void Main(string[] args)
        {
            //Documentインスタンスの作成
            Document document = new Document();

            //Word文書を読み込みます
            document.LoadFromFile("sample.docx");

            //カスタム文書プロパティを追加します
            CustomDocumentProperties customProperties = document.CustomDocumentProperties;
            customProperties.Add("ID", 1);
            customProperties.Add("Authorized", true);
            customProperties.Add("Authorized By", "小林");
            customProperties.Add("Authorized Date", DateTime.Today);

            //結果文書の保存
            document.SaveToFile("result.docx", FileFormat.Docx2013);
        }
    }
}

VB.NET:

Imports Spire.Doc
Imports System
Imports System.Reflection.Metadata

Namespace AddCustomDocumentProperties
    Class Program
        Shared Sub Main(ByVal args() As String)
            'Documentインスタンスの作成
            Dim document As Document = New Document()

            'Word文書を読み込みます
            document.LoadFromFile("sample.docx")

            'カスタム文書プロパティを追加します
            Dim customProperties As CustomDocumentProperties = document.CustomDocumentProperties
            customProperties.Add("ID", 1)
            customProperties.Add("Authorized ", True)
            customProperties.Add("Authorized By ", "小林")
            customProperties.Add("Authorized Date ", DateTime.Today)

            '結果文書の保存
            document.SaveToFile("Result.docx", FileFormat.Docx2013)
        End Sub
    End Class
End Namespace

上記のコードでは、まずCustomDocumentPropertiesという名前空間を定義し、その名前空間の下にProgramというクラスを作成して、プログラムのエントリーポイントとします。Main関数では、まずDocumentオブジェクトを作成し、それはWord文書のインスタンスを表します。次に、LoadFromFileメソッドを呼び出してWord文書を読み込みます。そして、CustomDocumentPropertiesオブジェクトを取得し、Add(string, object)メソッドを使用してカスタムプロパティを文書のカスタムプロパティコレクションに追加します。
最後に、SaveToFileメソッドを呼び出して変更された文書を保存します。