如何在 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 时，请注意它返回匹配文本的第一个实例。 如果您需要删除整个文档中出现的所有特定文本，请执行一个循环，继续搜索和删除，直到找不到匹配的文本为止。 这种迭代方法可确保对整个文档进行全面的文本删除。

查找和删除功能保留了删除文本之外的文档格式和结构。 段落分隔、周围文本格式和文档样式保持不变，这样既能保持文档的一致性，又能删除不需要的内容。