C# で Word 文書内のテキストを置換する方法

入力ドキュメントはどのようなものですか?

この例では、サンプル Word 文書を使用します。この文書には 2 つの段落があり、どちらも"古いテキスト"というテキストが含まれています。 この単純な構造は、段落レベルでテキスト置換がどのように機能するかを示しています。

どのように置換コードを書けばよいですか?

以下は、最初の段落の"古いテキスト"を"新しいテキスト"に置き換えるコードです。 インデックス表記を使用して特定の段落をターゲットにすることで、どのコンテンツが変更されるかを正確に制御していることに注目してください：

: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

上のコードはIronWordによるテキスト置換の簡単さを示しています。 ドキュメントを読み込み、特定の段落をターゲットにし、ReplaceTextを呼び出すことで、わずか数行のコードでドキュメントの内容を変更することができます。 このアプローチは、従来のOffice Interopの手法よりも簡単です。

出力はどのように見えますか?

出力ファイルでわかるように、最初の段落のテキストのみが変更され、2番目は変更されていません。 文書全体に影響を与えることなく特定のセクションを更新する必要がある場合、この選択的置換機能は非常に重要です。

複数の置換に必要なコードは何ですか?

以下は、文書全体を通して"古いテキスト"を"新しいテキスト"に置き換えるコードです：

: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

このループアプローチは、ドキュメントを完全にカバーします。 すべての段落を反復することで、ターゲットテキストのすべてのインスタンスが置換されるようにします。 この方法は、会社名の変更、用語の更新、文書全体の一貫した書式の適用など、一括更新の場合に特に有効です。

複数回置き換えた後、ドキュメントはどのようになりますか?

.

この更新されたWord文書からわかるように、両方の段落が"新しいテキスト"に置き換えられています。 これは、包括的なテキスト置換のためのループアプローチの有効性を示しています。

置き換える前にテキストが存在することを確認するにはどうすればよいですか?

操作を実行する前にテキストが存在することを確認する必要がある場合は、FindTextメソッドを使用してください。 このメソッドは文書全体を検索し、検索クエリと一致する最初のTextElementを返します。 この検証ステップは、変更を加える前に特定のコンテンツの存在を確認する必要がある場合や、ドキュメントのコンテンツに基づいて条件ロジックを構築する場合に役立ちます。

FindTextメソッドは、次のようなシナリオで特に役立ちます：

• どの文書に特定のテキストが含まれているかを記録する必要があります。
• テキストが見つかったかどうかに応じて、異なるアクションを実行する必要があります。
• 文書検証システムを構築中
• ドキュメントの内容に関するレポートを作成する必要があります。

上記の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

このコードはIronWordによるテキスト検索のシンプルさを示しています。 FindTextメソッドは、テキストが見つかればTextElementオブジェクトを返し、見つからなければNULLを返すので、検索結果に基づいて条件ロジックを簡単に実装できます。

テキストの検索結果は何を表示しますか?

.

ご覧のように、一致するテキストが返され、検索用語が文書内に存在することが確認されました。 この検証機能は、さまざまなコンテンツシナリオを処理する必要がある堅牢な文書処理アプリケーションを構築するために不可欠です。