IRONWORDの使用

C#でWordファイルを読み取る方法

リーガン・パン
リーガン・パン
2024年8月15日
共有:

今日では、Microsoft Wordドキュメントはオフィスの仕事やプロフェッショナル・パーソナルなコミュニケーションの代名詞となっています。 したがって、プログラムでWord文書を操作することは、アプリケーション内でユーザーに表示するタスクを自動化しようとする開発者にとって重要です。 利用可能なライブラリは多くありますが、すべてが同じように堅牢というわけではありません。 しかし、その中でひときわ目立つのはIronWordです。 IronWord は、信頼性が高く堅牢な C# Word DOCX ライブラリであり、使いやすく理解しやすく、Word ドキュメントの操作を簡素化します。

この記事では、IronWordを使用して短い例でWord文書を迅速に読み取る方法を探ります。

C#を使用してWordファイルを読み取る方法

  1. Visual Studioでコンソール・アプリケーションを作成する

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

  3. WordDocumentクラスを使用して新しいWordドキュメントを作成する

  4. Wordドキュメントにテキストを追加

  5. 各段落をParagraphクラスを使用してループする

  6. 内容を表示

IronWord: C# DOCXライブラリ

IronWord: C# DOCXライブラリ

IronWord は、アプリケーションに Word ドキュメントを統合する際の手間を省く、柔軟でスケーラブルなライブラリであり、使いやすくシンプルなAPIを備えています。 アプリケーションにシンプルなテキストワードドキュメントを追加して統合する場合でも、複雑なテーブルやレポートを作成してユーザーに表示する場合でも、IronWord ですべてカバーできます。

これがその最も注目すべき機能です。

  1. ドキュメント操作: IronWord は開発者が Word ドキュメントを簡単に操作することを可能にします。 ユーザーがテキストの段落や、表や画像などのより複雑な構造を挿入したい場合でも、IronWordならすべて対応できます。

  2. クロスプラットフォームのサポートと互換性: IronWord は柔軟に設計されており、複数のプラットフォームで開発者をサポートします。 それは、様々な.NET Core (8, 7, 6, 5, 3.1+)、.NET Standard (2.0+)、.NET Framework (4.6.2+)、さらにはAzureもサポートしています。 さらに、開発者はIronWordをWindows、Linux、macOS、Androidなどのさまざまなプラットフォームおよびシステムで利用できます。 最も一般的なプラットフォームをカバーし、開発者が迅速にクロスプラットフォームアプリケーションを構築することを可能にします。

  3. Microsoft Officeからの独立: .NetアプリケーションにWordドキュメントを統合する際によくある問題は、Interopのような一般的なライブラリがMicrosoft Officeのライセンスされたインストールを必要とすることです。しかし、IronWordはその制限に依存しないため、この問題を解決します。 開発者は、Microsoft Wordのライセンスおよびインストールに制約されることなく、Wordドキュメントの力を最大限に活用できます。

  4. フォーマットオプション: IronWordはフォーマットとスタイリングの幅広いサポートを提供し、開発者がドキュメントを独自のものにすることができます。 開発者は、フォントをテキストに適用し、色、配置、表のスタイルなどの複雑なフォーマットを行うことができます。

  5. 使いやすさと幅広いサポート: 理解しやすいAPIとわかりやすいメソッド呼び出しに加えて、IronWordは拡張APIリファレンスとコード例を提供しており、開発者がIronWordを最も効果的に活用する方法を判断するのに役立ちます。

Visual Studioで新しいコンソールプロジェクトを作成する

例に入る前に、Visual Studioで空のコンソールプロジェクトを作成しましょう。

新しいプロジェクトを作成するときにコンソールアプリをクリックします

次に、プロジェクトの名前と保存場所を指定します。

プロジェクトの名前と場所のパスを指定します。

次に、使用する .NET フレームワークを選択してください。 この例では、.NET 8.0を使用します。

希望する .NET フレームワークを選択し、「作成」をクリックします。

新しいコンソールプロジェクトを作成してセットアップした後、C#のワードライブラリ、IronWordをインストールしましょう。

IronWord のインストール

IronWordをインストールする方法は2つあります。

1. NuGetパッケージマネージャーを使用したインストール

NuGet パッケージ マネージャーを通じてインストールするには、ツールをクリックして `Manage NuGet Solutions.` を選択します。それから検索バーで IronWord を検索し、`IronWord.` をインストールします。

NuGet パッケージ マネージャーの検索バーで「IronWord」と検索し、ソリューションの NuGet パッケージの管理を使用して IronWord をインストールします。次にプロジェクトを選択し、インストール ボタンをクリックします。

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

代替方法として、NuGet パッケージ マネージャー コンソールを介してインストールする方法があります。 そうするには、コンソールで次のコマンドを実行します:

Install-Package IronWord
Install-Package IronWord
'INSTANT VB TODO TASK: The following line uses invalid syntax:
'Install-Package IronWord
$vbLabelText   $csharpLabel

ライセンスキー

IronWordはライセンスキーがなければ動作しないことをご了承ください。 無料トライアルの一環としてこちらから入手できます。

トレイルキーを取得した後、この変数がプロジェクト内で設定されていることを確認してください。

//Replace the license key variable with the trial key you obtained
IronWord.License.LicenseKey = "REPLACE-WITH-YOUR-KEY";
//Replace the license key variable with the trial key you obtained
IronWord.License.LicenseKey = "REPLACE-WITH-YOUR-KEY";
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

C#でWord文書を読み取る

前提条件をインストールした後、以下のコードでIronWordを使用してMicrosoft Wordドキュメントを読み込む簡単さを示します。

まず、次の名前空間をインポートします。 IronWord を使用して、新しいドキュメントを作成し、サンプルテキストを追加します。 次に、`WordDocument`オブジェクトを使用して段落とテキストにアクセスし、Word文書内のテキストを出力します。

using IronWord;
using IronWord.Models;
using SixLabors.Fonts;

# region
IronWord.License.LicenseKey = "YOUR-KEY-HERE";
#endregion
// Create textrun
Text textRunExample = new Text("Sample text");

Paragraph paragraphExample = new Paragraph();
paragraphExample.AddChild(textRunExample);

// Create a new Word document
WordDocument doc = new WordDocument(paragraphExample);

// Export docx
doc.SaveAs("document.docx");

// Access paragraphs and text runs

foreach (Paragraph paragraph in doc.Paragraphs)
{
    foreach (Text textRun in paragraph.Texts)
    {
        // Access text content
        string content = textRun.Text;
        // Display Contents
        Console.WriteLine(content);
    }
}
using IronWord;
using IronWord.Models;
using SixLabors.Fonts;

# region
IronWord.License.LicenseKey = "YOUR-KEY-HERE";
#endregion
// Create textrun
Text textRunExample = new Text("Sample text");

Paragraph paragraphExample = new Paragraph();
paragraphExample.AddChild(textRunExample);

// Create a new Word document
WordDocument doc = new WordDocument(paragraphExample);

// Export docx
doc.SaveAs("document.docx");

// Access paragraphs and text runs

foreach (Paragraph paragraph in doc.Paragraphs)
{
    foreach (Text textRun in paragraph.Texts)
    {
        // Access text content
        string content = textRun.Text;
        // Display Contents
        Console.WriteLine(content);
    }
}
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

上記のコードからワードファイルを読み取る方法とパラメータを探ってみましょう。

  1. 最初にTextオブジェクトを作成し、それに文字列「Sample Text」を割り当てます。

  2. 次に、Paragraph オブジェクトをインスタンス化し、「textRunExample」を追加します。

  3. また、WordDocument オブジェクトをインスタンス化し、それを `WordDocument doc,` と名付け、`paragraphExample` を渡して段落を含む新しいWord文書を作成します。

  4. コードは、後で使用するためにファイル名「document.docx」でWordドキュメントを保存します。

  5. 作成したWordドキュメント内の段落にアクセスするには、WordDocument オブジェクトの「Paragraphs」プロパティにアクセスします。 「Paragraphs」プロパティはリストです。そのため、foreachループを呼び出してそれを反復処理します。

  6. 段落内のテキストを取得するには、Paragraphsの「Texts」プロパティにアクセスします。 これもテキストのリストを返します。

  7. 最後に、Text を "content" という名前の文字列変数に割り当て、コンソールに出力します。

コンソール出力

Wordドキュメントから読み取ったテキストを表示するコンソール出力。

C#で既存のWordドキュメントを読む

前の例では、プログラムによって新しいWordドキュメントを作成し、その内容を読み取りました。 既存のWordドキュメントを読み取るために、いくつかのコード変更を行うことで、同様の手順を踏むことができます。

入力文書

入力例: 長文のWord文書

using IronWord;
using IronWord.Models;
using SixLabors.Fonts;

# region
IronWord.License.LicenseKey = "YOUR-KEY-HERE";
#endregion

// Export docx
WordDocument doc = new WordDocument("existing_document.docx");

// Access paragraphs and text runs

foreach (Paragraph paragraph in doc.Paragraphs)
{
    foreach (Text textRun in paragraph.Texts)
    {
        // Access text content
        string content = textRun.Text;
        // Display Contents
        Console.WriteLine(content);
    }
}
using IronWord;
using IronWord.Models;
using SixLabors.Fonts;

# region
IronWord.License.LicenseKey = "YOUR-KEY-HERE";
#endregion

// Export docx
WordDocument doc = new WordDocument("existing_document.docx");

// Access paragraphs and text runs

foreach (Paragraph paragraph in doc.Paragraphs)
{
    foreach (Text textRun in paragraph.Texts)
    {
        // Access text content
        string content = textRun.Text;
        // Display Contents
        Console.WriteLine(content);
    }
}
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

2つの例の主な違いは、WordDocument オブジェクトに渡されるパラメータです。 新しいドキュメントを作成する代わりに、既存のWordファイルをロードします。 残りは他の例と同じです。

コンソール出力

コンソール出力

結論

IronWordライセンス情報

例を通じて、C#でWordドキュメントをプログラム的に操作および読み取るためにIronWordライブラリを使用することがいかに簡単であるかを示しました。 IronWord ライブラリの柔軟性と拡張性により、テンプレートの記入、レポートの生成、ドキュメントのバッチ処理など、実際の例でIronWordを使用することができる貴重なツールとなっています。 Wordがアプリケーションと統合する仕組みを理解することは、開発者に問題解決のためのより多くのソリューションを提供するために貴重です。

さらに、開発者はIronWordの豊富な機能を購入前に一定期間試すことができ、無料試用ライセンスを提供しています。 使いやすさに加えて、IronWord には豊富なドキュメントと開発者向けの24時間年中無休のサポートが付属しており、生産時に開発者が直面する可能性のある恒常的なフラストレーションを軽減します。 また、様々なチュートリアルや、IronWordの使用を開始する際の参考になるコード例を提供しています。

トライアルライセンスを使用してIronWordのさまざまな機能をテストした後、$599から始まるLiteデベロッパーライセンスを購入することができ、LiteからProfessionalまでアップグレード可能です。 詳しくは、私たちのライセンスページをご覧ください。

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