IRONWORDの使用

C#でDOCXファイルを作成する方法

リーガン・パン
リーガン・パン
2024年4月3日
共有:

イントロダクション

今日のデジタル環境における多くのアプリケーションは、文書を自動的に生成し、変更する能力を必要とする。 DOCXファイルを作成し作業する機能は、企業レベルの報告システムを構築する場合でも、文書管理システムを構築する場合でも、単に反復作業を自動化する場合でも便利です。 このチュートリアルでは、C#ドキュメント生成の世界に飛び込み、DOCXファイルを作成するためにC#で使用できる堅牢なライブラリとプログラミング手法を検証します。

C#(シーシャープ)でDOCXファイルを作成する方法;

  1. NuGetパッケージIronWord をインストールします。

  2. 必要なネームスペースを取り、IronWord からインポートする。

  3. 文書ファイルを生成するには、新しいTextRunを追加します。

  4. 新しいボディとドキュメントを作成する。

  5. 本文をコンテンツ(段落、表など)で埋めてください。

  6. WordDocumentを使って、新しいWordDocumentを作成する。

  7. Document オブジェクトを TextRun, Paragraph Document プロパティに代入すると、変更が保存されます。

DOCXフォーマットを知る

コーディングに入る前に、DOCXファイルとは何かを明らかにしておこう。 Microsoft Wordやその他のワードプロセッシングプログラムは、DOCXファイル形式で文書を保存します。 それは、ZIP圧縮されたXMLベースの[Office Open XML (OOXML) 標準](https://en.wikipedia.org/wiki/Office_Open_XML#:~:text=Office%20Open%20XML%20(also%20informally,initial%20version%20as%20ECMA%2D376.)に基づいています。 そのため、マイクロソフトや他の開発者が提供するAPIを利用すれば、比較的簡単にプログラムで操作することができる。

IronWord

Iron Softwareは、 IronWordとして知られるWordドキュメントライブラリを作成しました。 .NETアプリケーションでWord文書を操作するための強力な機能を提供することに関しては。 IronWord は、.NET用IronWordライブラリであり、.NET C#開発者がプログラム内でWordやDOCXドキュメントを作成、読み込み、修正できるよう支援します。

IronWordの特徴

  • DOCとDOCXの作成と編集:IronWord は、.NETプロジェクト内でWordドキュメントの作成と編集を可能にすることで、Office InteropやMicrosoft Wordのインストールを不要にします。
  • 既存のドキュメントを開いて編集し、WordファイルとDocxを保存する: Wordドキュメントの構造はカスタマイズ可能であり、ページ設定(背景色、余白、用紙サイズ、向き)を含みます。
  • 言葉や写真を含める:シンプルなAPIを使って、Word文書にテキストやグラフィックをすばやく追加できます。
  • クロスプラットフォームのサポート:IronWordは.NET 8、7、6、コア、スタンダード、フレームワークと互換性があり、C#、F#、VB.NET用に構築されています。 Docker、iOS、Android、Windows、Linuxなど複数の環境で機能する。
  • 世界中で数百万人のエンジニアがIronWordに信頼を寄せています:IronWordは、9つのIron Suite for .NET(.NET APIオフィス・ドキュメント製品)から構成されています。 世界中の開発者がワード文書を作成、閲覧、修正するために使用している。

    IronWord について詳しく知るには こちら をご参照ください。

Visual Studioで新しいプロジェクトを作成

Visual Studioアプリケーションを起動するには、[ファイル]メニューから[ファイル]を選択します。New Project "をクリックし、"Console application "を選択します。

C#でDOCXファイルを作成する方法: 図1 - 新規プロジェクトの作成

ファイルの場所を選択した後、指定されたテキストフィールドにプロジェクト名を入力してください。 次に、以下のサンプルに示されているように、[Create] ボタンをクリックし、必要な .NET Framework を選択します。

C#でDOCXファイルを作成する方法: 図2 - プロジェクト名およびファイルパスの設定

Visual Studio プロジェクトの構成は、選択されたアプリケーションに依存します。 コードを追加してアプリケーションを構築するには、program.csファイルを開くだけです。インターネットアプリケーション、Windows、またはコンソールをすべて利用可能です。

その後、ライブラリを追加し、コードをテストすることができる。

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

Visual Studioツールの活用 ツールメニューからNuGet Package Managerを選択します。 パッケージマネージャーインターフェースに入り、パッケージ管理端末コンソールにアクセスしてください。

Install-Package IronWord

パッケージをダウンロードしてインストールした後、現在進行中のプロジェクトで利用できます。

C#でDOCXファイルを作成する方法: 図3 - パッケージマネージャーコンソールでのIronWordのインストール

また、パッケージマネージャーの方法もあります。 パッケージを直接ソリューションにインストールするには、Visual StudioのNuGetパッケージマネージャーオプションを使用できます。 以下の画像で、NuGetパッケージマネージャーの起動方法をご覧いただけます。

C#でDOCXファイルを作成する方法: 図4 - NuGetパッケージマネージャーの見つけ方

NuGetウェブサイトの検索ボックスを使用してパッケージを探します。 下のスクリーンショットのように、パッケージマネージャーで「IronWord 」を探すだけだ:

C#でDOCXファイルを作成する方法: 図5 - NuGetパッケージマネージャーでIronWordをインストールする

上記の画像には関連する検索結果の一覧が表示されています。 お使いのマシンにソフトウェアをインストールするには、これらの設定を調整するだけです。

IronWordを使ったDOCXの作成

新しいWord文書を開始するためにWordDocumentオブジェクトをインスタンス化する。 ドキュメントを初期化するには、段落、表、セクションなど、ドキュメントの構造を構成する任意のオブジェクトを使用できます。 次のコード・スニペットで簡単に説明しよう:

using IronWord;
using IronWord.Models;
namespace ConsoleApp1
{
    internal class Program
    {
        static void Main(string [] args)
        {
            // Create a text run
            TextRun textRun = new TextRun("Hello, IronPdf");
            Paragraph paragraph = new Paragraph();
            paragraph.AddTextRun(textRun);
            // Create a new document
            WordDocument doc = new WordDocument(paragraph);
            // Export the DOCX file
            doc.SaveAs("document.docx");
        }
    }
}
using IronWord;
using IronWord.Models;
namespace ConsoleApp1
{
    internal class Program
    {
        static void Main(string [] args)
        {
            // Create a text run
            TextRun textRun = new TextRun("Hello, IronPdf");
            Paragraph paragraph = new Paragraph();
            paragraph.AddTextRun(textRun);
            // Create a new document
            WordDocument doc = new WordDocument(paragraph);
            // Export the DOCX file
            doc.SaveAs("document.docx");
        }
    }
}
Imports IronWord
Imports IronWord.Models
Namespace ConsoleApp1
	Friend Class Program
		Shared Sub Main(ByVal args() As String)
			' Create a text run
			Dim textRun As New TextRun("Hello, IronPdf")
			Dim paragraph As New Paragraph()
			paragraph.AddTextRun(textRun)
			' Create a new document
			Dim doc As New WordDocument(paragraph)
			' Export the DOCX file
			doc.SaveAs("document.docx")
		End Sub
	End Class
End Namespace
$vbLabelText   $csharpLabel

AddTextRunメソッドの助けを借りてパラグラフオブジェクトにテキストを渡すことができます。 次に、新しいDOCXファイルを作成するために、新しいWordDocumentオブジェクトを作成します。そして、SaveAsメソッドを使用して、新しいDOCXドキュメントを任意の場所に保存します。 以下は上記のコードから生成された出力です。

C#でDOCXファイルを作成する方法: 図6 - 前のコードからの出力PDF

IronWordコードの詳細については、こちらをご参照ください。

結論

このガイドでは、C#(シーシャープ)を使ってDOCX文書ファイルを生成する方法を見てきました。DOCXフォーマットの基本について、Open XML SDKとDocXライブラリとともに説明し、それらを使用してDOCXファイルを生成、編集、保存する方法を例示しました。

これらのツールやメソッドはすべて、C#(シーシャープ)プロジェクトでさまざまなドキュメント作成の雑用を処理するための強力なポジションを提供します。 C#(シーシャープ)で文書作成を学ぶことは、レポート作成の自動化、文書管理システムの開発、エンドユーザー向けのテンプレートの作成など、様々な場面で役立つ能力です。

.NET C#で作業する開発者向けに、IronWordは強力で柔軟なWordドキュメントライブラリです。 これにより、開発者はアプリでWord(DOCX)ドキュメントを簡単に読み取り、書き込み、および編集できます。 IronWord のユーザーフレンドリーなAPIは、Word文書の処理をより簡単にします。 Microsoft WordのインストールやOffice Interopに依存することなく、開発者は.NETプロジェクト内で直接Wordファイルを作成・編集することができます。 新しいWord文書にテキスト、段落、その他の要素を簡単に追加できます。

IronWordは、初登場時に$749です。 さらに、1年間の会費を支払った顧客は、製品に関するサポートや最新情報を受け取ることができる。 IronWordは有料で、無制限な再配布に対する防御を提供する。 おおよその費用について詳しく知るには、このページをご覧ください。 このリンクをクリックしてIron Softwareの詳細をご覧ください。

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