IRONWORDの使用

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

リーガン・パン
リーガン・パン
2023年12月24日
共有:

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ウェブページ

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ドキュメントの作成を開始する準備が整いました。

NuGetパッケージマネージャーでIronWordをインストールする

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

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

Install-Package IronWord

ワード文書作成の手順

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

  1. IronWord 名前空間のインポート:
using IronWord;
using IronWord.Models;
using IronWord;
using IronWord.Models;
Imports IronWord
Imports IronWord.Models
$vbLabelText   $csharpLabel

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

  1. Word文書インスタンスの作成
WordDocument doc = new WordDocument();
WordDocument doc = new WordDocument();
Dim doc As New WordDocument()
$vbLabelText   $csharpLabel

ここでは、WordDocumentクラスの新しいインスタンスが作成される。 これは、コンテンツを追加し始めることができる空のWord新規ドキュメントを表します。

  1. ドキュメントにコンテンツを追加する:

    以下のサンプル・コードでは、ドキュメント・オブジェクトにテキストを追加しています:

doc.AddText("Add text using IronWord");
doc.AddText("Add text using IronWord");
doc.AddText("Add text using IronWord")
$vbLabelText   $csharpLabel

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

  1. 文書を保存する:
doc.SaveAs("save_document.docx");
doc.SaveAs("save_document.docx");
doc.SaveAs("save_document.docx")
$vbLabelText   $csharpLabel

文書にコンテンツを追加した後、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
$vbLabelText   $csharpLabel

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

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

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

出力

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

前のコードから出力されたPDF

結論

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

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

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

リーガン・パン
ソフトウェアエンジニア
レーガンはリーディング大学で電子工学の学士号を取得しました。Iron Softwareに入社する前の仕事では、一つのタスクに集中して取り組んでいました。Iron Softwareでは、営業、技術サポート、製品開発、マーケティングのいずれにおいても広範な業務に携わることが最も楽しいと感じています。彼は、Iron Softwareライブラリを開発者がどのように使用しているかを理解し、その知識を使ってドキュメントを継続的に改善し、製品を開発することを楽しんでいます。
< 以前
C#を使用してWordドキュメントを操作する方法
次へ >
C# Word編集(コード例開発者チュートリアル)