How to Replace Text in a Word Document with C

輸入文檔是什麼樣的？

在這個範例中，我們將使用這個包含兩個段落​​的範例 Word 文檔，這兩個段落的文字都是"舊文字"。 這個簡單的結構演示了段落層級的文字替換是如何運作的。

我該如何編寫替換程式碼？

以下是將第一段的"舊文字"替換為"新文字"的程式碼。 請注意我們如何使用索引符號來定位特定段落，從而精確控制要修改的內容：

: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");

上面的程式碼示範了使用IronWord進行文字替換的簡單性。 透過載入文檔，選擇特定段落，然後呼叫 ReplaceText，您只需幾行程式碼即可修改文檔內容。 這種方法比傳統的Office互通方法更直接。

輸出結果是什麼樣子的？

從輸出檔可以看到，只有第一段的文字被更改了，而第二段的文字保持不變。 當您需要更新特定部分而不影響整個文件時，這種選擇性替換功能至關重要。

多次更換零件需要什麼代碼？

以下程式碼可將整個文件中所有出現的"舊文字"替換為"新文字"：

: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");

這種循環方法可以對文件進行全面覆蓋。 透過遍歷每個段落，您可以確保所有目標文字實例都被替換。 這種方法對於批次更新特別有用，例如更改公司名稱、更新術語或在文件中套用一致的格式。

多次替換後，文檔會變成什麼樣子？

從這份更新後的 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"));

這段程式碼示範了使用IronWord進行文字搜尋的簡單性。 FindText 方法如果找到文字則傳回一個 TextElement 對象，如果未找到文字則傳回 null，這使得根據搜尋結果實作條件邏輯變得容易。

尋找文字的結果顯示什麼？

如您所見，它傳回了匹配的文本，證實了搜尋字詞存在於文件中。 這種驗證功能對於建立需要處理各種內容場景的強大文件處理應用程式至關重要。