如何在 C# 中從 DOCX 檔案中刪除文本

如何從 Word 文件中刪除整個段落？

若要從 Word 文件中刪除段落，請使用其索引位置透過 Paragraphs 集合存取它。 此範例刪除索引為 1 的段落，這將刪除其所有內容和格式。 刪除後，文件結構會自動調整，後續段落會向上移動以填補空缺。

在進行段落刪除操作時，請記住索引是從零開始的。 第一段的索引為 0，第二段的索引為 1，依此類推。 Remove() 方法會從文件結構中完全刪除段落元素，包括該段落中的所有文字、格式以及任何嵌入的內容，例如圖像或超連結。

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

using IronWord;

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

// Remove the second paragraph
doc.Paragraphs[1].Remove();

// Export the file
doc.SaveAs("text_document_modified.docx");

文件移除前的樣子是什麼樣的？

刪除後文檔結構會發生怎樣的變化？

刪除操作會保持文件的整體格式和結構不變。 其餘段落保留其原有的顏色和格式屬性。 這是使用 IronWord 刪除方法的關鍵優勢——它們在乾淨俐落地刪除目標元素的同時，也能保持周圍內容的完整性。

如何刪除段落中特定的格式化文字？

一個段落可以包含多個文字行，其中每個文字行代表具有一致格式屬性(如粗體、斜體或顏色)的文字。 了解文字結構對於精確的內容操作至關重要。 段落內每次格式發生變化時，都會開始一個新的文字運行。 例如，如果一個句子中有一個單字是粗體，那麼通常會有三個文本段：粗體單字之前的文字、粗體單字本身以及粗體單字之後的文字。

若要刪除段落中的特定格式化內容，請造訪 Texts 集合，並按索引尋找所需的文字。 此範例刪除了第一段中的第三段文字(索引 2)，而保留了其他內容。 這種精細的控制方式可讓您在刪除特定格式化片段的同時保留段落結構。

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

using IronWord;

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

// Remove the first paragraph's third textrun
doc.Paragraphs[0].Texts[2].Remove();

// Export the file
doc.SaveAs("sample_after_textrun_removal.docx");

處理文字行時，請記得刪除一個文字行不會影響周圍文字行的格式。 每次文字運行都獨立保持其格式屬性。 這樣就可以精準地刪除特定的格式化內容，而不會破壞剩餘文字的視覺外觀。

刪除前文本運行會發生什麼變化？

刪除一段文字會如何影響段落格式？

如圖所示，刪除特定文字行不會影響其餘內容的格式完整性。 下劃線的文字和其他格式屬性保持不變，這表示文字運行操作非常精確。

如何根據內容而非位置找到並刪除文字？

FindText 方法根據文字匹配而不是位置動態地定位和刪除內容。 這對於刪除文件中任何位置的無效文字、佔位符或特定內容尤其有用，而無需知道其確切位置。 此方法傳回符合的文字元素，如果找不到則傳回 null，從而允許在呼叫 Remove 之前進行 null 檢查以安全地刪除。

這種方法在處理需要刪除佔位符文字的範本文檔，或清理具有已知錯誤模式的文檔時非常有價值。 FindText 方法預設執行區分大小寫的搜索，確保與目標內容精確匹配。

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

using IronWord;

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

// Find and remove erroneous text
var textToRemove = doc.FindText("ERRONEOUS TEXT IS HERE.");
textToRemove?.Remove();

// Save the cleaned document
doc.SaveAs("sample_cleaned.docx");

上述程式碼中的空條件運算子(?.)對於安全執行至關重要。 如果找不到文本，則傳回 null，而空條件運算子會阻止 FindText。 這種模式可以使你的程式碼在處理目標文字可能並非總是存在的文件時更加健壯。

在使用"尋找和刪除"功能前，我應該查找哪些內容？

FindText 如何處理多次出現的情況？

使用 FindText 時，請注意它傳回符合文字的第一個實例。 如果需要刪除文件中所有出現的特定文本，請實現一個循環，不斷搜尋和刪除，直到找不到更多匹配項為止。 這種迭代方法可確保對整個文件進行全面的文字刪除。

尋找和刪除功能會保留文件中除已刪除文字之外的格式和結構。 段落分隔符號、周圍文字的格式和文件樣式保持不變，因此在刪除不需要的內容的同時，可以安全地保持文件的一致性。