如何使用 C# 編輯 Word 文件中的文本

如何在Word文檔中編輯文字？

若要編輯 Word 文件中的文本，請載入現有文件並存取目標段落。 該段落公開了一個Texts數組， Texts[0]引用該段落中的第一個文字運行。 文字段是指格式一致的文字部分。 這種方法在保持文件原始結構的同時，也能以程式方式更新特定內容。

如果一個段落包含多種格式樣式，則每個不同的段落都是一個單獨的文字段。

處理商務文件時，您需要在不改變整體格式的情況下更新特定部分。 IronWord 能夠保留文件的版面、樣式和格式，同時允許精確的文字修改。 這對於更新範本文件、個人化格式信函或維護動態報告非常有效。

:path=/static-assets/word/content-code-examples/how-to/edit-text-simple.cs

using IronWord;

// Load a DOCX document
WordDocument doc = new WordDocument("raw_document.docx");

// Edit existing text on the first paragraph
doc.Paragraphs[0].Texts[0].Text = "First paragraph is updated successfully";

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

上面的程式碼示範了文字編輯的基本方法。 載入文件時，IronWord 會將其結構解析為物件層次結構。 每個段落包含一個或多個文字片段，這些片段可以獨立存取和修改。 這種精細的控制確保格式在內容變更時保持不變。

編輯前的文檔是什麼樣子的？

文字修改後會發生哪些變化？

上圖所示的轉換說明了 IronWord 如何在文字編輯過程中保持文件完整性。 請注意，格式（包括顏色和樣式）保持不變，只有文字內容會改變。 保持格式對於在商業應用中維護專業文件標準至關重要。

如何編輯特定文字？

當一個段落包含多個格式不同的文字行時，可以使用陣列索引來定位特定的文字行。 文字運行採用從零開始的索引，其中Texts[0]是第一次運行， Texts[1]是第二次運行，依此類推。 在這個例子中，我們使用Paragraphs[3].Texts[1]來定位第四段的第二個文字。

了解文字結構對於精確編輯文件至關重要。 如果一個段落包含以下內容，則該段落可能包含多個文字片段：

• 不同的字體樣式（粗體、斜體、底線）
• 各種字體大小或顏色
• 同一段落內存在混合格式
• 超連結或特殊字符

:path=/static-assets/word/content-code-examples/how-to/edit-text-text-run.cs

using IronWord;

// Load the document
WordDocument doc = new WordDocument("text_document.docx");

// Edit second text run in the 4th paragraph
doc.Paragraphs[3].Texts[1].Text = "Edited the textrun successfully within the same paragraph";

// Save to the same file
doc.SaveAs("text_document.docx");

這種方法在更新文件時能夠提供精準的指導。 例如，如果一段文字中只有某些單字加粗或顏色不同，則每次格式變更都會建立一個新的文字段。 透過針對特定運行進行操作，您可以只更新所需的內容，而不會影響周圍的文字或格式。

為什麼文字行數對格式很重要？

文字行是 Word 格式系統的基礎。 每次運行都會維護自己的一組屬性，包括字體系列、大小、顏色和樣式屬性。 編輯特定文字段時，這些屬性將保持不變，確保您的文件保持其專業外觀。 在使用企業模板或品牌文件時，這一點尤其重要，因為在這些情況下，格式的一致性是必須的。

當我指定要執行的文字時會發生什麼？

視覺回饋會準確地顯示哪個文字行被修改了。 這種精確編輯功能對於需要以下功能的應用程式來說非常重要：

• 更新表單範本中的特定字段
• 修改合約文件中的變數
• 更改行銷資料中的佔位符
• 在保持格式不變的情況下更新報告中的資料點

文字編輯最佳實踐

在應用程式中實現文字編輯功能時，請考慮以下最佳實踐：

錯誤處理：在嘗試修改段落和文字之前，務必先驗證它們是否存在。 使用邊界檢查來防止索引超出範圍異常：

if (doc.Paragraphs.Count > 0 && doc.Paragraphs[0].Texts.Count > 0)
{
    doc.Paragraphs[0].Texts[0].Text = "Safe update";
}

if (doc.Paragraphs.Count > 0 && doc.Paragraphs[0].Texts.Count > 0)
{
    doc.Paragraphs[0].Texts[0].Text = "Safe update";
}

保留格式：請記住，每段文字都有自己的格式。 如果您需要保持編輯文字的格式一致，則可能需要適當地合併或分割文字區段。

效能注意事項：編輯多個文字元素時，載入一次文檔，進行所有必要的更改，最後儲存一次。 這種方法可以最大限度地減少 I/O 操作，提高效能。

文件備份：在進行大量修改之前，請考慮建立原始文件的備份副本。 這種做法可以確保資料安全，並在需要時提供回滾選項。

透過遵循這些指導原則並了解文字運作結構，您可以建立強大的文件編輯解決方案，在保持專業品質的同時，有效率地自動更新內容。