如何在 C# 中移除 DOCX 中的文字#

IronWord 提供多種以 C# 語言從 Word 文件移除文字的方法，包括移除整個段落、特定文字運行，以及在刪除前依內容尋找文字，所有這些都能保留文件結構與格式的完整性。

開始使用 IronWord

!{--01001100010010010100001001010010010000010101001001011001010111110101001101010100010001010101010 10100010111110101010001010010010010010100000101001100010111110100001001001100010011111010000100100110001001111010101

快速入門：從 DOCX 中移除文字。

1.透過 NuGet 套件管理員安裝 IronWord 2.使用 WordDocument 載入您的 DOCX 檔案 3.依索引存取段落或文字 4.在目標元素上呼叫 Remove() 5.儲存修改後的文件

如何從 Word 文件中移除整個段落？ 若要從 Word 文件中移除段落，請使用其索引位置透過 `Paragraphs` 集合存取。 本範例刪除索引 1 的段落，刪除其所有內容和格式。 文件結構在移除後會自動調整，後續段落會上移以填補空隙。 在進行段落移除時，請記住索引是以零為基礎的。 第一段在索引 0，第二段在索引 1，以此類推。 `Remove()` 方法會將段落元素從文件結構中完全移除，包括該段落中的所有文字運行、格式化以及任何內嵌內容（如圖片或超連結）。 ```csharp :path=/static-assets/word/content-code-examples/how-to/remove-text-simple.cs ```

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

移除後的文件結構會如何改變？

移除作業會保持文件的整體格式和結構。 其餘段落保留原始顏色和格式屬性。 這是使用 IronWord 刪除方法的主要優點 - 既能保持周遭內容的完整性，又能乾淨地刪除目標元素。

如何移除段落中特定的格式化文字？ 一個段落可以包含多個文字行，其中每個文字行代表具有一致格式屬性（如粗體、斜體或顏色）的文字。 理解文字運行對於精確的內容處理至關重要。 每次在段落中變更格式時，都會開始新的文字運行。 例如，如果您有一個句子，其中有一個字是粗體字，您通常會有三個文字運行：粗體字之前的文字、粗體字本身，以及粗體字之後的文字。 若要刪除段落中的特定格式化內容，請造訪`Texts`集合，然後按索引尋找所需的文字。 此範例刪除了第一段中的第三段文字（索引 2），而保留了其他內容。 這種粒度控制可讓您保留段落結構，同時只移除特定格式的片段。 ```csharp :path=/static-assets/word/content-code-examples/how-to/remove-text-text-run.cs ``` 使用文字符號時，請記住移除文字符號並不會影響周圍符號的格式。 每個文字運行都會獨立保持其格式屬性。 這樣就可以在不破壞剩餘文字視覺外觀的情況下，以外科手術的方式移除特定格式化的內容。

移除前的文字會發生什麼變化？

移除文字符號如何影響段落格式？

如圖片所示，移除特定的文字運行可維持剩餘內容的格式完整性。 下劃線文字和其他格式屬性保持不變，展現文字運行操作的精準度。

如何根據內容而非位置來尋找和移除文字？ `FindText`方法根據文字匹配而不是位置動態地定位和刪除內容。 這對於移除文件中任何位置的無效文字、占位符或特定內容而不知道其確切位置特別有用。 此方法傳回符合的文字元素，如果找不到則傳回 null，從而允許在呼叫`Remove`之前進行 null 檢查以安全地刪除元素。 在處理需要移除占位符文字的範本文件，或清理已知錯誤模式的文件時，這種方法非常有價值。 `FindText` 方法預設會執行大小寫敏感搜尋，以確保精確匹配目標內容。 ```csharp :path=/static-assets/word/content-code-examples/how-to/remove-text-find.cs ``` 上述程式碼中的 null-conditional 運算符 (`?.`) 對於安全執行至關重要。 如果未找到文字，`FindText` 會返回 null，而 null 條件運算符號可防止 `NullReferenceException` 產生。 當您處理目標文字不一定存在的文件時，此模式可讓您的程式碼更為穩健。

在使用查找和移除之前，我應該查找哪些內容？

FindText 如何處理多重出現？

使用 `FindText` 時，請注意它會返回匹配文字的第一次出現。 如果您需要移除整個文件中所有出現的特定文字，請執行一個循環，持續搜尋並移除，直到找不到更多符合的文字為止。 這種反覆的方法可確保在整個文件中進行全面的文字移除。 查找和移除功能保留了文件的格式和結構，但不包括被移除的文字。 段落分隔、周遭文字的格式化以及文件樣式都會保持不變，使其成為維持文件一致性的安全作業，同時移除不需要的內容。