C#でWordドキュメントを作成する方法

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

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

C#（シーシャープ）でWord文書を作成する方法；

1. Visual StudioでC#（シーシャープ）プロジェクトを作成する

2. IronWord ライブラリのインストール

3. WordDocumentオブジェクトの作成

4. AddTextメソッドを使用してコンテンツを追加する

5. WordDocumentオブジェクトにテキストParagraphを追加する

6. SaveASメソッドを使用してDOCXファイルに保存する

IronWord・ライブラリー

IronWord ライブラリは、Iron Software が開発した強力な C# DOCX ライブラリです。 Microsoft OfficeやWord Interopをインストールすることなく、Word文書を構築、編集、エクスポートするための直感的なAPIを提供します。さまざまな.NETバージョンとプラットフォームをサポートするIronWord は、さまざまな環境でWordファイルを扱うプロセスを簡素化します。

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

IronWordの特徴

クロスプラットフォーム対応

IronWordはC#、F#、VB.NET上で動作するように設計されており、.NET 8、7、6、5、コア、スタンダード、またはフレームワークをサポートしています。 ウェブ、モバイル、デスクトップ、コンソールの各アプリケーションで活用できる汎用性がある。

ドキュメント構造の操作

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

スタイリングとフォーマット

このライブラリによって、開発者はフォントファミリーやサイズ、色、太字、斜体、取り消し線、下線、上付き文字、下付き文字など、さまざまな要素のスタイル設定を行うことができる。 さらに、整列、背景色、箇条書き／番号リストのカスタマイズにも対応している。

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

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

環境の設定

まず、Visual Studio を開き、ウェルカムスクリーンが表示されます。

1.新しい.NETフレームワーク・コンソール・アプリケーションの作成

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

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

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

パッケージマネージャーコンソールを使用する：

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

Install-Package IronWord

Install-Package IronWord

ワード文書作成の手順

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

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

using IronWord;
using IronWord.Models;

using IronWord;
using IronWord.Models;

Imports IronWord
Imports IronWord.Models

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

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

WordDocument doc = new WordDocument();

WordDocument doc = 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")

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

4. 文書を保存する：

doc.SaveAs("save_document.docx");

doc.SaveAs("save_document.docx");

doc.SaveAs("save_document.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
    doc.AddText("Add text using IronWord");

        // Save the document
        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
    doc.AddText("Add text using IronWord");

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

Imports IronWord
Imports IronWord.Models

Friend Class Program
	Shared Sub Main()
		' Create a new Word document
		Dim doc As New WordDocument()

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

		' Save the document
		doc.SaveAs("output.docx")
	End Sub
End Class

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

これは簡単な例であり、アプリケーションの要件に基づいて、より複雑なドキュメント構造、フォーマット、および追加のコンテンツを含めるように拡張することができます。

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

出力

プログラムを実行すると、「output.docx」という名前のWord文書がプロジェクト・ディレクトリに生成される。 この文書を開いて、追加された内容を見ることができる。

結論

この記事では、C#（シーシャープ）アプリケーションでMicrosoft Wordファイルを作成することの意義を探り、Word文書を扱うための強力なソリューションとしてIronWord ライブラリを紹介した。 その機能、Visual StudioでC#（シーシャープ）コンソール・プロジェクトをセットアップする手順、そしてIronWord をインストールしてWord文書を作成する手順について説明した。 IronWord を使えば、開発者はC# (シーシャープ)アプリケーションにWord文書生成機能をシームレスに統合し、文書処理機能を強化することができる。

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

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