Microsoft Word ファイルはドキュメントの作成と編集に広く使用されており、多くのビジネス アプリケーションの基本的な部分となっています。 C# 開発では、MS Word ドキュメントをプログラムで生成および操作する機能が重要です。 これを実現するための強力なツールの 1 つが IronWord ライブラリです。このライブラリは、C# で Word ファイルを操作するための包括的な機能セットを提供します。

Microsoft は、Visual C# を使用して Microsoft Word ドキュメントを自動化するための開発者向けチュートリアルも提供しています。 この記事では、強力な C# Word ドキュメント ライブラリである IronWord を使用して C# で Word ドキュメントを作成する方法について説明します。

How to Create Word Documents in C#

1. Visual StudioでC#プロジェクトを作成
2. IronWordライブラリをインストールする
3. WordDocumentオブジェクトを作成する
4. AddTextメソッドを使用してコンテンツを追加する
5. WordDocumentオブジェクトにテキストParagraphを追加します。
6. SaveAsメソッドを使用してDOCXファイルに保存する

IronWord ライブラリ

IronWordライブラリは、Iron Software によって開発された堅牢な C# DOCX ライブラリです。 IronWordは、Microsoft OfficeやWord Interopをインストールする必要なく、Word文書の作成、編集、エクスポートのための直感的なAPIを提供します。様々な.NETバージョンとプラットフォームをサポートしているため、IronWordはさまざまな環境でのWordファイルの操作プロセスを簡素化します。

IronWordはWordアプリをインストールしなくても動作します。Wordドキュメントの作成にはMicrosoft Word Interopは必要ありません。

IronWordの機能

クロスプラットフォームサポート

IronWord は、.NET 8、7、6、5、Core、Standard、または Framework をサポートし、C#、F#、VB.NET 上で実行できるように設計されています。 Web、モバイル、デスクトップ、コンソール アプリケーションで利用できるほど汎用性があります。

ドキュメント構造の操作

IronWord は、Word ファイルの読み取りや編集など、ドキュメント構造を操作するための豊富な機能を提供します。 開発者は、テキストと画像を抽出し、ページ設定を編集し、カスタム余白を設定し、段落、テキスト ラン、画像、図形、表を追加できます。

スタイルとフォーマット

このライブラリを使用すると、開発者はフォント ファミリとサイズ、色、太字、斜体、取り消し線、下線、上付き文字、下付き文字など、さまざまな要素のスタイルを設定できます。 さらに、配置、背景色、箇条書き/番号付きリストのカスタマイズもサポートしています。

クロスプラットフォームの互換性

IronWord は、Windows、Linux、macOS、iOS、Android などのさまざまなオペレーティング システムと互換性があり、幅広いアプリケーションに対応する多目的ソリューションです。

環境の設定

まず、 Visual Studioを開くと、ようこそ画面が表示されます。

1. 新しい.NET Frameworkコンソールアプリケーションを作成する

"新しいプロジェクトの作成"をクリックします。"コンソール アプリ (.NET Framework)"を検索し、リストから選択して"次へ"をクリックします。プロジェクトに名前を付けて"作成"をクリックします。Visual Studio は、エントリ ポイントとして Main メソッドを含む基本テンプレートを使用して、新しい .NET Framework コンソール アプリケーションを設定します。

2. NuGet パッケージ マネージャーを使用して IronWord をインストールする

Visual Studio で、"ツール"メニューに移動し、"NuGet パッケージ マネージャー"を選択して、"ソリューションの NuGet パッケージの管理"を選択します。NuGet ウィンドウで、"参照"タブに移動し、検索ボックスに"IronWord"と入力して Enter キーを押します。 結果からパッケージを選択し、右側でコンソール アプリケーション プロジェクトがチェックされていることを確認し、"インストール"をクリックします。これにより、C# アプリケーション内で IronWord を使用するために必要な参照が追加されます。 これで、 IronWordを使用して Word 文書の作成を開始する準備が整いました。

パッケージ マネージャー コンソールの使用:

パッケージ マネージャー コンソールで次のコマンドを実行します。

Install-Package IronWord

Word文書を作成する手順

IronWord がインストールされたので、ライブラリを使用してWord 文書を作成できます。

1. IronWord名前空間のインポート:

using IronWord;
using IronWord.Models;

using IronWord;
using IronWord.Models;

Imports IronWord
Imports IronWord.Models

Imports IronWord
Imports IronWord.Models

これらの行はIronWord.Modelsの名前空間をインポートし、C#コードでIronWordライブラリからクラスや機能を使用できるようにします。

2. Word 文書インスタンスの作成:

WordDocument doc = new WordDocument();

WordDocument doc = new WordDocument();

Dim doc As New WordDocument()

Dim doc As New WordDocument()

ここでは、WordDocumentクラスの新しいインスタンスが作成されます。 これは、コンテンツの追加を開始できる空の Word 文書を表します。

3. ドキュメントにコンテンツを追加する: 次のサンプル コードは、ドキュメント オブジェクトにテキストを追加します。

doc.AddText("Add text using IronWord");

doc.AddText("Add text using IronWord");

doc.AddText("Add text using IronWord")

doc.AddText("Add text using IronWord")

この行は、"IronWord を使用してテキストを追加"というテキストを含む段落を Word 文書に追加します。 AddTextメソッドは、ドキュメントにテキストコンテンツを挿入する便利な方法です。

4. ドキュメントを保存する:

doc.SaveAs("output.docx");

doc.SaveAs("output.docx");

doc.SaveAs("output.docx")

doc.SaveAs("output.docx")

ドキュメントにコンテンツを追加した後、SaveAsメソッドを使用してWordドキュメントをファイルに保存します。この場合、プロジェクトディレクトリに"output.docx"というファイル名でドキュメントを保存します。

上記の手順により、新しい Word 文書が作成され、テキストを含む段落が追加され、指定されたファイル名で文書が保存されます。

完全なソースコードは次のとおりです。

using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        // Create a new Word document
        WordDocument doc = new WordDocument();
        
        // Add text to the document
        doc.AddText("Add text using IronWord");

        // Save the document to a file
        doc.SaveAs("output.docx");
    }
}

using IronWord;
using IronWord.Models;

class Program
{
    static void Main()
    {
        // Create a new Word document
        WordDocument doc = new WordDocument();
        
        // Add text to the document
        doc.AddText("Add text using IronWord");

        // Save the document to a file
        doc.SaveAs("output.docx");
    }
}

Imports IronWord
Imports IronWord.Models

Module Program
    Sub Main()
        ' Create a new Word document
        Dim doc As New WordDocument()
        
        ' Add text to the document
        doc.AddText("Add text using IronWord")

        ' Save the document to a file
        doc.SaveAs("output.docx")
    End Sub
End Module

Imports IronWord
Imports IronWord.Models

Module Program
    Sub Main()
        ' Create a new Word document
        Dim doc As New WordDocument()
        
        ' Add text to the document
        doc.AddText("Add text using IronWord")

        ' Save the document to a file
        doc.SaveAs("output.docx")
    End Sub
End Module

全体として、このコードは、IronWord ライブラリを使用して Word 文書を作成する基本的な手順を示しています。 WordDocumentオブジェクトをインスタンス化し、コンテンツ（この場合は単純な段落）を追加して、文書をファイルに保存します。これで完了です。 ドキュメントは正常に作成されました。

これは単純な例であり、アプリケーションの要件に応じて、より複雑なドキュメント構造、書式設定、および追加コンテンツを含めるように拡張できます。

Word 文書を作成、読み取り、既存の文書を編集する方法の詳細なコード例については、このコード例のページをご覧ください。

出力

プログラムを実行すると、プロジェクト ディレクトリに"output.docx"という名前の Word 文書が生成されます。 このドキュメントを開くと、追加されたコンテンツを確認できます。

結論

この記事では、C# アプリケーションで Microsoft Word ファイルを作成することの重要性を説明し、Word 文書を操作するための強力なソリューションとして IronWord ライブラリを紹介しました。 IronWord の機能、Visual Studio で C# コンソール プロジェクトを設定するプロセス、IronWord をインストールして使用し Word 文書を作成する手順について説明しました。 IronWord を使用すると、開発者は Word ドキュメント生成機能を C# アプリケーションにシームレスに統合し、ドキュメント処理機能を強化できます。

IronWord とその機能の詳細については、公式ドキュメントページをご覧ください。

IronWord は開発目的では無料で使用でき、商用利用のライセンスを取得できます。 ただし、決定を下す前に商用モードで完全な機能をテストするための無料トライアルも提供されています。