C#でワードテンプレートを使用してワード文書を生成する方法

C#でWordテンプレートを使用してWord文書を生成する方法

1. Microsoft Visual Studio で新しいプロジェクトを作成します。
2. NuGet パッケージ マネージャーを使用してIronWordをインストールします。
3. Word テンプレート文書を作成します。
4. Word 文書にデータを挿入し、新しいファイルとして保存します。
5. 生成された Word 文書にテキスト効果を追加します。

IronWordとは何ですか？

IronWord は、Microsoft Word ドキュメントをプログラムで簡単に作成、操作、管理できるように設計されたIron Softwareの .NET ライブラリです。 これにより、開発者は Word 文書の生成プロセスを自動化できるため、アプリケーション内でレポート、請求書、手紙、その他の種類の文書を動的に作成することが容易になります。

前提条件

始める前に以下を確認してください:

• マシンに Visual Studio がインストールされている。
• 最新の .NET フレームワークがインストールされている。

ステップ 1: Microsoft Visual Studio で新しいプロジェクトを作成します。

では、新しい Visual Studio プロジェクトを作成することから始めましょう。

C#でWordテンプレートを使用してWord文書を生成する方法: 図1

以下の画面でコンソール アプリケーション テンプレートを選択します。

C#でWordテンプレートを使用してWord文書を生成する方法: 図2 - コンソールアプリの選択

プロジェクト名と場所を指定します。

C#でWordテンプレートを使用してWord文書を生成する方法: 図3 - 名前と場所を指定する

できれば最新のサポート付きの .NET バージョンを選択し、"作成"をクリックします。

C#でWordテンプレートを使用してWord文書を生成する方法: 図4

ステップ 2: IronWord NuGet パッケージ マネージャーをインストールします。

Visual Studio で以下のように NuGet パッケージ マネージャーから IronWord NuGet パッケージをインストールします。

C#でWordテンプレートを使用してWord文書を生成する方法: 図5 - NuGetパッケージマネージャーからIronWordを検索

あるいは、以下のコマンドを使用して、CLI から直接インストールしてください。

dotnet add package IronWord --version 2024.9.1

dotnet add package IronWord --version 2024.9.1

ステップ 3: Word テンプレート ドキュメントを作成します。

次に、Word ドキュメント生成プロセス中に使用される 1 ページまたは 2 ページの Word テンプレート ドキュメントを生成します。

Dear {Name},

Thanks for purchasing {product}. We are happy to serve you always. Your application dated {Date} has been approved. The product comes with an expiry date of {expiryDate}. Renew the product on or before the expiry date.

Feel free to contact {phone} or {email} for further queries.

Address: {Address}

Thank you,

{Sender}

次に、上記のドキュメントをTemplate.docxとして保存します。

ステップ 4: Word 文書にデータを挿入し、新しいファイルとして保存します。

using System;
using System.Collections.Generic;
using IronWord;

class Program
{
    static void Main()
    {
        // Set the license key for IronWord
        License.LicenseKey = "your key";

        // Define paths for the template and the output file
        string templatePath = "Template.docx";
        string outputPath = "FilledDocument.docx";

        // Create a new instance of the WordDocument class using the template path
        WordDocument doc = new WordDocument(templatePath);

        // Define a dictionary of placeholders and their replacements
        var replacements = new Dictionary<string, string>
        {
            { "{Name}", "John Doe" },
            { "{Date}", DateTime.Now.ToString("MMMM d, yyyy") },
            { "{Address}", "123 Iron Street, Iron Software" },
            { "{product}", "IronWord" },
            { "{Sender}", "IronSoftware" },
            { "{phone}", "+123 456789" },
            { "{email}", "sale@ironsoftware.com" },
            { "{expiryDate}", DateTime.Now.AddYears(1).ToString("MMMM d, yyyy") },
        };

        // Replace placeholders in the document with actual data
        foreach (var replacement in replacements)
        {
            doc.Texts.ForEach(x => x.Replace(replacement.Key, replacement.Value));
        }

        // Save the filled document
        doc.Save(outputPath);

        // Notify the user that the document has been saved successfully
        Console.WriteLine("Document filled and saved successfully.");
    }
}

using System;
using System.Collections.Generic;
using IronWord;

class Program
{
    static void Main()
    {
        // Set the license key for IronWord
        License.LicenseKey = "your key";

        // Define paths for the template and the output file
        string templatePath = "Template.docx";
        string outputPath = "FilledDocument.docx";

        // Create a new instance of the WordDocument class using the template path
        WordDocument doc = new WordDocument(templatePath);

        // Define a dictionary of placeholders and their replacements
        var replacements = new Dictionary<string, string>
        {
            { "{Name}", "John Doe" },
            { "{Date}", DateTime.Now.ToString("MMMM d, yyyy") },
            { "{Address}", "123 Iron Street, Iron Software" },
            { "{product}", "IronWord" },
            { "{Sender}", "IronSoftware" },
            { "{phone}", "+123 456789" },
            { "{email}", "sale@ironsoftware.com" },
            { "{expiryDate}", DateTime.Now.AddYears(1).ToString("MMMM d, yyyy") },
        };

        // Replace placeholders in the document with actual data
        foreach (var replacement in replacements)
        {
            doc.Texts.ForEach(x => x.Replace(replacement.Key, replacement.Value));
        }

        // Save the filled document
        doc.Save(outputPath);

        // Notify the user that the document has been saved successfully
        Console.WriteLine("Document filled and saved successfully.");
    }
}

ステップ 5: 生成された Word 文書にテキスト効果を追加します。

IronWord では、下の表に示すように、さまざまなテキスト効果を追加することもできます。

次の例では、"Iron Software"という単語にテキスト効果を追加します。

using System;
using System.Collections.Generic;
using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        // Set the license key for IronWord
        License.LicenseKey = "your key";

        // Define paths for the template and the output file
        string templatePath = "Template.docx";
        string outputPath = "glowEffect.docx";

        // Create a new instance of the WordDocument class
        WordDocument doc = new WordDocument(templatePath);

        // Define a dictionary of placeholders and their replacements
        var replacements = new Dictionary<string, string>
        {
            { "{Name}", "John Doe" },
            { "{Date}", DateTime.Now.ToString("MMMM d, yyyy") },
            { "{Address}", "123 Iron Street, Iron Software" },
            { "{product}", "IronWord" },
            { "{Sender}", "Sale," },
            { "{phone}", "+123 456789" },
            { "{email}", "sale@ironsoftware.com" },
            { "{expiryDate}", DateTime.Now.AddYears(1).ToString("MMMM d, yyyy") },
        };

        // Replace placeholders in the document with actual data
        foreach (var replacement in replacements)
        {
            doc.Texts.ForEach(x => x.Replace(replacement.Key, replacement.Value));
        }

        // Create and configure text style methods with a glow effect
        TextStyle textStyle = new TextStyle
        {
            TextEffect = new TextEffect()
            {
                GlowEffect = new Glow()
                {
                    GlowColor = IronWord.Models.Color.Aqua,
                    GlowRadius = 10,
                },
            }
        };

        // Add styled text to the document
        doc.AddText(" IronSoftware").Style = textStyle;

        // Save the document with the glow effect
        doc.SaveAs(outputPath);

        // Notify the user that the document has been saved successfully
        Console.WriteLine("Styled document saved successfully.");
    }
}

using System;
using System.Collections.Generic;
using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        // Set the license key for IronWord
        License.LicenseKey = "your key";

        // Define paths for the template and the output file
        string templatePath = "Template.docx";
        string outputPath = "glowEffect.docx";

        // Create a new instance of the WordDocument class
        WordDocument doc = new WordDocument(templatePath);

        // Define a dictionary of placeholders and their replacements
        var replacements = new Dictionary<string, string>
        {
            { "{Name}", "John Doe" },
            { "{Date}", DateTime.Now.ToString("MMMM d, yyyy") },
            { "{Address}", "123 Iron Street, Iron Software" },
            { "{product}", "IronWord" },
            { "{Sender}", "Sale," },
            { "{phone}", "+123 456789" },
            { "{email}", "sale@ironsoftware.com" },
            { "{expiryDate}", DateTime.Now.AddYears(1).ToString("MMMM d, yyyy") },
        };

        // Replace placeholders in the document with actual data
        foreach (var replacement in replacements)
        {
            doc.Texts.ForEach(x => x.Replace(replacement.Key, replacement.Value));
        }

        // Create and configure text style methods with a glow effect
        TextStyle textStyle = new TextStyle
        {
            TextEffect = new TextEffect()
            {
                GlowEffect = new Glow()
                {
                    GlowColor = IronWord.Models.Color.Aqua,
                    GlowRadius = 10,
                },
            }
        };

        // Add styled text to the document
        doc.AddText(" IronSoftware").Style = textStyle;

        // Save the document with the glow effect
        doc.SaveAs(outputPath);

        // Notify the user that the document has been saved successfully
        Console.WriteLine("Styled document saved successfully.");
    }
}

説明

修正されたコードは、IronWord ライブラリを使用して Word 文書テンプレートに入力し、テキストにスタイルを設定し、変更された文書を保存する方法を示しています。 簡潔な説明は次のとおりです。

1.ライセンス設定:機能を有効にするために IronWord ライセンス キーを設定します。 2.ファイル パス:テンプレート ( Template.docx ) と出力ファイル ( glowEffect.docx ) のパスを指定します。 3.ドキュメント インスタンスの作成:指定されたテンプレート パスを使用してWordDocumentインスタンスを初期化します。 4.置換の定義:プレースホルダーとそれに対応する置換値の辞書を作成します。 5.プレースホルダーの置き換え:辞書を反復処理して、ドキュメント内のプレースホルダーを実際のデータに置き換えます。 6.テキスト スタイルの設定:色と半径を指定して、グロー効果のあるテキスト スタイルを定義します。 7.スタイル付きテキストの追加:設定されたスタイルを持つテキストをドキュメントに追加します。 8.ドキュメントを保存:適用されたテキスト スタイルを反映して、更新されたドキュメントを新しい名前 ( glowEffect.docx ) で保存します。 9.コンソール出力:スタイル設定されたドキュメントが保存されたことを確認するメッセージが出力されます。

出力

C#でWordテンプレートを使用してWord文書を生成する方法: 図8 - Word出力の例

IronWord ライセンス

アイアンワード。 Once the data is entered, the license is delivered to the email ID provided. このライセンスは、以下のように、 IronWordライブラリを使用する前にコードの先頭に配置する必要があります。

License.LicenseKey = "your Key Here";

License.LicenseKey = "your Key Here";

結論

IronWord には、テンプレートを使用して Word 文書を生成するいくつかの利点があります。 開発者が特定のデータをプログラムでテンプレートに入力できるようにすることで、ドキュメント作成の自動化を簡素化し、手動入力の必要性を減らします。 これにより、人為的エラーのリスクが最小限に抑えられ、効率と精度が向上します。 さらに、 IronWord はドキュメント間の一貫性を維持し、生成される各ファイルが同じ形式と構造に準拠していることを保証します。 反復的なタスクを自動化すると、時間とリソースが節約され、大量のドキュメントを迅速に作成するのに最適です。 IronWord は、頻繁または複雑なドキュメント生成を必要とするシナリオで生産性を向上させ、ワークフローを合理化します。

この記事で概説されている手順に従い、 IronWordで提供された例を活用することで、ドキュメント生成のニーズを効率的に管理し、ワークフローを合理化できます。