How to Replace Text in a Word Document

This article was translated from English: Does it need improvement?
Translated
View the article in English

Word文書でのテキスト置換の自動化は、テンプレートの個別化、レポートの更新、大量のコンテンツの管理など、一般的なニーズです。IronWordは、この作業を簡単かつ効率的にするために設計されたC#ライブラリです。

IronWordの主な利点は、Microsoft Office Interopに依存せず、直接Word文書を操作することです。つまり、サーバーにWordをインストールする必要がなく、非常に高速で、信頼性が高く、スケーラブルなバックエンドプロセスやWebアプリケーション用のソリューションが実現します。

このハウツーガイドでは、コード例を通じて、任意のWord文書内のテキストをどのように簡単に見つけて置換できるかを示します。

クイックスタート: Word文書内のテキストを簡単に置換

このクイックガイドでは、IronWordを用いてWord文書内のテキストを迅速に置換する方法を示します。 わずか数行のC#コードで、DOCXファイルを読み込み、指定されたテキストを置換し、更新された文書を保存することができます。 この効率的なプロセスにより、Microsoft Office Interopを必要とせずに文書の自動化を強化できるため、バックエンドプロセスやWebアプリケーションに最適です。

Nuget IconGet started making PDFs with NuGet now:

  1. Install IronWord with NuGet Package Manager

    PM > Install-Package IronWord

  2. Copy and run this code snippet.

    IronWord.Document doc = new IronWord.Document("sample.docx");
    doc.ReplaceText("oldText", "newText");
    doc.SaveAs("updated.docx");
  3. Deploy to test on your live environment

    Start using IronWord in your project today with a free trial
    arrow pointer
class="hsg-featured-snippet">

最小ワークフロー(5ステップ)

  1. Word文書内の単語を置換するためのC#ライブラリをダウンロードする
  2. 既存のWord文書を読み込む
  3. Word文書の段落とテキストにアクセスする
  4. 古いテキストを新しいテキストにReplaceTextを使用して置換する
  5. 更新されたWord文書を保存する

テキスト置換の例

Word文書内のテキスト置換は、IronWordを使うと直感的です。 まず、既存の文書を読み込みます。 次に、Paragraphsを通じて段落コレクションにアクセスし、特定の段落にReplaceTextメソッドを使用します。

ReplaceTextメソッドは、2つの文字列パラメータを取り、見つけたいテキストと置換するテキストを指定します。

[{t:(ReplaceTextメソッドは大小文字を区別し、選択された段落内の文字列のすべてのインスタンスを置換します。)}]

[{t:(この例で使用されるすべてのオブジェクトリストはゼロベースのインデックスに従います。)}]

入力

この例では、サンプルWord文書を使用し、2つの段落が含まれ、両方に「古いテキスト」があります。

class="content-img-align-center">
class="center-image-wrapper"> Sample Docx

コード

以下のコードでは、「古いテキスト」の最初の段落を「新しいテキスト」に置換します。

:path=/static-assets/word/content-code-examples/how-to/replace-words.cs
using IronWord;

// Open existing Word
WordDocument doc = new WordDocument("sample.docx");

// Replace the first paragraph's old text with new text
doc.Paragraphs[0].ReplaceText("old text", "new text");

// Save updated Word Document
doc.SaveAs("updated.docx");
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

出力

class="content-img-align-center">
class="center-image-wrapper"> Output Docx

出力ファイルでわかるように、最初の段落のテキストのみが変更され、2番目は変更されていません。

複数のテキストを置換

文書全体のすべての単語の出現を置換するには、Paragraphsコレクションをループし、各段落にReplaceTextメソッドを適用します。

以前と同じsample.docxファイルを使用します。 置換するテキストが段落内に見つからない場合、操作は実行されず、ループは次の段落に進みます。

[{i:(置換したいテキストが見つからない場合、操作は実行されません。)}]

コード

以下のコードでは、「古いテキスト」の最初の段落を「新しいテキスト」に置換します。

:path=/static-assets/word/content-code-examples/how-to/replace-words-multiple.cs
using IronWord;

// Open existing Word
WordDocument doc = new WordDocument("sample.docx");

// Loop through each paragraph to find and replace text
for (int i = 0; i < doc.Paragraphs.Count; i++)
{
    // Replace all occurrences of "old text" with "new text" in the current paragraph
    doc.Paragraphs[i].ReplaceText("old text", "new text");
}

// Save updated Word Document
doc.SaveAs("updated.docx");
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

出力

class="content-img-align-center">
class="center-image-wrapper"> Output Multiple Docx

更新されたWord文書からわかるように、両方の段落が「新しいテキスト」に置換されています。

テキストを探す

操作を実行する前にテキストの存在を確認する必要がある場合は、FindTextメソッドを使用できます。 このメソッドは文書全体を検索し、検索クエリと一致する最初のTextElementを返します。

上記のWord文書で古いテキストを検索する例を以下に示します。

コード

:path=/static-assets/word/content-code-examples/how-to/replace-words-find-text.cs
using IronWord;
using System;

// Open existing Word
WordDocument doc = new WordDocument("sample.docx");

// Returns the first TextContent element that contains the specified text.
Console.WriteLine(doc.FindText("old text"));
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

出力

class="content-img-align-center">
class="center-image-wrapper"> Find Text Output

ご覧のとおり、一致するテキストが返されました。

[{w:(FindTextが何も返さない場合、ドキュメント内にテキストが存在しないことを示します。)] 検索用語が正しくスペルされ、文書内のテキストの大文字小文字と一致していることを確認してください。)}]

よくある質問

IronWord はどのように使用されますか?

IronWord は Word ドキュメントでのテキスト置換を自動化するために使用される C# ライブラリです。テンプレートのパーソナライズ、レポートの更新、大量のコンテンツ管理といったタスクを簡略化します。

IronWord を使用するために Microsoft Word をインストールする必要がありますか?

いいえ、IronWord は Microsoft Office Interop に依存していないため、サーバーに Word をインストールする必要はありません。これにより、Word ドキュメントを操作するためのより速く、よりスケーラブルなソリューションになります。

IronWord を使用して Word ドキュメント内のテキストをどのように置き換えるのですか?

IronWord を使用して Word ドキュメントのテキストを置き換えるには、ドキュメントをロードし、段落にアクセスし、ReplaceText メソッドを使用して古いテキストを新しいテキストに置き換えます。

IronWord の ReplaceText メソッドは大文字小文字を区別しますか?

はい、IronWord の ReplaceText メソッドは大文字小文字を区別し、指定された文字列のすべてのインスタンスを選択した段落内で置き換えます。

IronWord でドキュメント全体のテキストを置き換えることはできますか?

はい、Paragraphs コレクションをループして各段落に ReplaceText メソッドを適用することで、ドキュメント全体のテキストを置き換えることができます。

置換するテキストが段落に見つからない場合はどうなりますか?

テキストが段落に見つからない場合、何も動作は行われず、ループは次の段落に進みます。

IronWord を使用してドキュメント内に特定のテキストが存在するかどうかを確認するにはどうすればよいですか?

ドキュメント全体を検索して、検索クエリに一致する最初の TextElement を返す FindText メソッドを使用できます。

FindText が何も返さない場合はどうすればよいですか?

FindText が何も返さなかった場合、テキストはドキュメント内に存在しないことを意味します。検索用語が正しく綴られ、大文字小文字が一致していることを確認してください。

Curtis Chau
テクニカルライター

Curtis Chauは、カールトン大学でコンピュータサイエンスの学士号を取得し、Node.js、TypeScript、JavaScript、およびReactに精通したフロントエンド開発を専門としています。直感的で美しいユーザーインターフェースを作成することに情熱を持ち、Curtisは現代のフレームワークを用いた開発や、構造の良い視覚的に魅力的なマニュアルの作成を楽しんでいます。

開発以外にも、CurtisはIoT(Internet of Things)への強い関心を持ち、ハードウェアとソフトウェアの統合方法を模索しています。余暇には、ゲームをしたりDiscordボットを作成したりして、技術に対する愛情と創造性を組み合わせています。

準備はいいですか?
Nuget ダウンロード 25,807 | バージョン: 2025.11 ただ今リリースされました