C#を使用してワード文書を操作する方法

C#を使用してWordドキュメントを操作する方法

1. 新しいVisual Studioプロジェクトを作成します。
2. Wordドキュメントを読み取るために必要なライブラリを設定します。
3. Wordドキュメントを操作するには、既存のファイルを読み込むか新しいファイルを作成します。
4. ドキュメントデータを編集し、ファイルを解析します。
5. 作成されたすべてのオブジェクトを削除します。

Microsoft Interopとは何ですか

C#やVB.NETで書かれたプログラムは、Microsoft WordのOffice相互運用性を使用してWordドキュメント（DOC、DOCX、RTF）を作成または開くことができます。 しかし、プロジェクトで使用すると、多くの欠点があります。

この記事では、C#またはVB.NETからMicrosoft Office Interop（Word Automation）を使用する際に遭遇する可能性がある一般的な問題について説明します。

例えば：

• ワード自動化に必要なすべてのクライアントPCは、Microsoft Wordのライセンスが必要です。
• すべてのクライアントのPCには、同じバージョンのMicrosoft Wordをインストールする必要があります。
• 自動化が利用されると、WordはバックグラウンドでさまざまなファイルとDLLをロードするためにいくつかのメガバイトのRAMを使用します。
• Microsoft Word APIは、COMオブジェクトを通じてアクセスされます。 管理コードからCOMオブジェクトを呼び出すときに、型変換やCOMラッパーが必要なこと、.NET Frameworkとの統合が不十分なことなどの問題が発生する可能性があります。

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

Install-Package Microsoft.Office.Interop.Word

Interopを使用して既存のWordドキュメントを操作する

Microsoft Wordを使用するには、まずMicrosoft.Office.Interop.Word.Applicationのインスタンスを作成する必要があります。 Wordドキュメントの通信は、このインスタンスで行われます。 次のステップは、作成したMicrosoft.Office.Interop.Word.ApplicationインスタンスのDocumentsプロパティを使用して、新しいWordドキュメントインスタンスを作成することです。 以下のC#コードスニペットに示されているように、これにより、プログラムによってWordドキュメントを操作できます：

using System;
using Microsoft.Office.Interop.Word;

class Program
{
    static void Main()
    {
        try
        {
            // Create a new instance of Word Application
            var WordApp = new Microsoft.Office.Interop.Word.Application();
            // Open an existing document
            var WordDoc = WordApp.Documents.Open(@"d:/Demo.docx");
            // Edit the content of the first paragraph
            WordDoc.Paragraphs[1].Range.Text = "New text here...";
            // Save the edited document
            WordDoc.SaveAs(@"d:/NewDemo.docx");
            // Close the document
            WordDoc.Close();
            // Quit the Word application
            WordApp.Quit();
        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.ToString());
        }
    }
}

using System;
using Microsoft.Office.Interop.Word;

class Program
{
    static void Main()
    {
        try
        {
            // Create a new instance of Word Application
            var WordApp = new Microsoft.Office.Interop.Word.Application();
            // Open an existing document
            var WordDoc = WordApp.Documents.Open(@"d:/Demo.docx");
            // Edit the content of the first paragraph
            WordDoc.Paragraphs[1].Range.Text = "New text here...";
            // Save the edited document
            WordDoc.SaveAs(@"d:/NewDemo.docx");
            // Close the document
            WordDoc.Close();
            // Quit the Word application
            WordApp.Quit();
        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.ToString());
        }
    }
}

Imports System
Imports Microsoft.Office.Interop.Word

Friend Class Program
	Shared Sub Main()
		Try
			' Create a new instance of Word Application
			Dim WordApp = New Microsoft.Office.Interop.Word.Application()
			' Open an existing document
			Dim WordDoc = WordApp.Documents.Open("d:/Demo.docx")
			' Edit the content of the first paragraph
			WordDoc.Paragraphs(1).Range.Text = "New text here..."
			' Save the edited document
			WordDoc.SaveAs("d:/NewDemo.docx")
			' Close the document
			WordDoc.Close()
			' Quit the Word application
			WordApp.Quit()
		Catch ex As Exception
			Console.WriteLine(ex.ToString())
		End Try
	End Sub
End Class

上記のコードでは、C#でWordドキュメントを編集することができます。 まず、Interopを使用してWordアプリケーションのインスタンスを作成します。次にOpenメソッドを使用して既存のWordファイルを開き、それをドキュメントオブジェクトに変換します。 これにより、ドキュメントと対話するために利用可能ないくつかのプロパティとメソッドにアクセスできます。 例では、Paragraphsコレクションとインデックスを使用して編集する段落を指定し、最初の段落のテキストを更新します。 最後に、SaveAsで変更を保存し、ドキュメントとアプリケーションを正しく閉じます。

Interopに代わるIronXLライブラリ

IronXLは、.NETプログラムでExcelファイルを操作するためのMicrosoft Interopの代替手段です。 Microsoft InteropがExcelをInteropアセンブリを介して操作する必要がある一方で、IronXLは、.NETコンテキストでExcelファイルをプログラムによって操作するためのより簡単で、効果的で強力な方法を提供します。

Microsoft Interopの代わりにIronXLを使用することには、いくつかの利点があります。例えば：

• パフォーマンスとリソース効率: IronXLは、コンピュータにExcelアプリケーションがインストールされることで依存しないため、Microsoft Interopよりも優れたパフォーマンスを発揮し、リソースの消費を抑えます。
• 使いやすさとシンプルさ: IronXLは、Microsoft Interopに付随する複雑さなしに、Excelファイルの読み取り、書き込み、操作を簡単にするAPIを提供します。
• 互換性と依存性: IronXLはMicrosoft Excelのインストールをコンピュータに必要としないため、ExcelやOfficeのさまざまなバージョンで発生する可能性のある依存性や互換性の問題を排除します。
• プラットフォーム独立性: IronXLは、特定のMicrosoft Officeバージョンとより密接に関連する可能性のあるMicrosoft Interopとは異なり、さまざまな環境やプラットフォームでの展開の容易さの点でより柔軟性を提供します。

.NET開発者がExcelファイルをプログラムによって扱う必要がある場合、IronXLはその使いやすさ、速度、サードパーティのソフトウェアインストールへの依存の低減によってしばしば優れた選択肢とされます。 ただし、IronXLとMicrosoft Interopの選択は、プロジェクトの具体的な要件や既存のインフラストラクチャ、およびそれぞれのライブラリに対するユーザーの専門知識のレベルによって影響を受ける可能性があります。

これらのオプションの選択時には、常にアプリケーションの要件を考慮してください。 IronXLライブラリの詳細については、こちらのリンクをご覧ください。

IronXLライブラリをインストールする

今後のパッチに必要なIronXLライブラリをインストールします。 これを完了するには、NuGetパッケージマネージャーコンソールを開いて次のコマンドを入力します：

Install-Package IronWord

NuGetパッケージマネージャーを介してパッケージ"IronXL"を検索することも選択肢の一つです。このIronXLに関連するすべてのNuGetパッケージの中から、必要なものを選択してダウンロードできます。

IronXLを使用してExcelドキュメントを編集する

数行のコードでデータをXLSXまたはXLS形式にエクスポートできます。 次のソースコードの例では、Excelファイルからデータをシンプルな表形式にエクスポートする方法を示しています：

using IronXL;

class Program
{
    static void Main()
    {
        // Load an existing Excel file
        var workbook = WorkBook.Load("Demo file.xlsx");
        // Access the first sheet or the sheet by name
        var ws = workbook.GetWorkSheet("Sheet1");
        // Read a value from a cell and output it to the console
        string address_val = ws["A1"].ToString();
        Console.WriteLine(address_val);
        // Modify a cell's value
        ws["A2"].Value = "Hello World";
        // Save the workbook to different formats
        workbook.SaveAs("export.xlsx");
        workbook.SaveAs("export.xls");
        workbook.WorkSheets[0].SaveAs("export.xls");
    }
}

using IronXL;

class Program
{
    static void Main()
    {
        // Load an existing Excel file
        var workbook = WorkBook.Load("Demo file.xlsx");
        // Access the first sheet or the sheet by name
        var ws = workbook.GetWorkSheet("Sheet1");
        // Read a value from a cell and output it to the console
        string address_val = ws["A1"].ToString();
        Console.WriteLine(address_val);
        // Modify a cell's value
        ws["A2"].Value = "Hello World";
        // Save the workbook to different formats
        workbook.SaveAs("export.xlsx");
        workbook.SaveAs("export.xls");
        workbook.WorkSheets[0].SaveAs("export.xls");
    }
}

Imports IronXL

Friend Class Program
	Shared Sub Main()
		' Load an existing Excel file
		Dim workbook = WorkBook.Load("Demo file.xlsx")
		' Access the first sheet or the sheet by name
		Dim ws = workbook.GetWorkSheet("Sheet1")
		' Read a value from a cell and output it to the console
		Dim address_val As String = ws("A1").ToString()
		Console.WriteLine(address_val)
		' Modify a cell's value
		ws("A2").Value = "Hello World"
		' Save the workbook to different formats
		workbook.SaveAs("export.xlsx")
		workbook.SaveAs("export.xls")
		workbook.WorkSheets(0).SaveAs("export.xls")
	End Sub
End Class

前の例では、ファイルパスと名前の引数を取るLoad関数を呼び出すことにより、既存のExcelファイルをロードします。 ファイルのWorkBookオブジェクトへのインポートが完了しました。 Excelワークシートは、シート名を使用してワークシートを読み込むことができるGetWorkSheetの助けを借りて、読み込まれます。 次に、Excelアドレスを使用して値を読み取ります。 Excelファイルの読み取りについては、ここ<／a>をクリックして詳細を確認してください。

また、インデックス値を使用したり、名前を指定して特定のExcelワークシートを選択できます。 次に、SaveAsオプションを使用して、Excelスプレッドシートからのデータを別のファイルにエクスポートできます。 Excelファイルの書式設定とエクスポートに関する詳細を知るには、こちらをクリックしてください。

結論

IronXLは、Excel用の最も人気のあるアドオンの1つです。 追加の外部ライブラリに依存しません。 セルフコンテインされているため、Microsoft Excelをインストールする必要はありません。 複数のチャネルを介して動作します。 これは、Wordドキュメントを編集するために追加のライブラリを使用してファイルを解析する必要があるInteropライブラリとは対照的です。

Microsoft Excelドキュメントを利用するあらゆるプログラミングプロセスに対する完全なソリューションがIronXLです。 計算、文字列または数字のソート、枝刈り、追加、検索と置換、結合と非結合、ファイル保存など、利用可能な操作が多数あります。 スプレッドシートデータの検証だけでなく、新しい形式のセルデータを構築することも可能です。 ファイルの読み書きおよびExcelデータの操作を支援します。

IronXLが初めて発売されたとき、$799の費用がかかりました。 または、顧客は1年間のサブスクリプション料を支払ってソフトウェアの更新とサポートを受け取ることを選択することができます。 料金を支払うことにより、IronXLは不正な再配布からの保護を提供します。 IronXLライセンスのページへ。 Iron Software製品について詳しくお知りになりたい方はこちらをご覧ください。