使用 IronWord 从 DOCX 中提取文本

IronWord 的 ExtractText() 方法使您能够通过访问整个文档、特定段落或表格单元格从 DOCX 文件中提取文本，为 C# 中的文档处理和数据分析任务提供了一个简单的 API。

as-heading:2（快速入门：从 DOCX 中提取文本）

1.安装 IronWord NuGet 软件包：<代码>Install-Package IronWord</代码 2.创建或加载 WordDocument：WordDocument doc = new WordDocument("document.docx"); 3.提取所有文本：string text = doc.ExtractText(); 4.从特定段落中摘录：string para = doc.Paragraphs[0].ExtractText(); 5.从表格单元格中提取：string cell = doc.Tables[0].Rows[0].Cells[0].ExtractText();

从 DOCX 文件中提取文本是文档处理和数据分析的常见需求。 IronWord 提供了一种简单的方法来读取和提取现有 DOCX 文件中的文本内容，允许您以编程方式访问段落、表格和其他文本元素。

本教程详细介绍了 ExtractText() 方法，并演示了如何从各种文档元素中访问文本。 无论您是在构建文档索引系统、内容管理解决方案还是数据提取管道，了解如何从 Word 文档中有效提取文本都是至关重要的。

开始使用 IronWord

今天在您的项目中使用 IronWord，免费试用。

第一步：

免费开始

如何从 DOCX 文档中提取所有文本？ `ExtractText()` 方法从整个 Word 文档中检索文本内容。 在这个例子中，我们创建一个新文档，向其中添加文本，使用`ExtractText()`提取文本，并将其显示在控制台中。 这展示了主要的文本提取工作流程。 提取的文本必须保持文档的逻辑阅读顺序。 该方法依次处理标题、段落、列表和其他文本元素，非常适合内容分析和搜索索引应用。 ```csharp :path=/static-assets/word/content-code-examples/how-to/extract-text-simple.cs ```

提取的文本是什么样的？

我应该在控制台中期待什么样的输出？

如何从特定段落中提取文本？ 为了更好地控制，您可以从特定段落中提取文本，而不是从整个文档中提取。 通过访问`Paragraphs`集合，您可以定位并处理所需的任何段落。 在处理具有结构化内容的文档或需要独立处理特定部分时，这种细化方法非常有用。 在本例中，我们从第一段和最后一段中提取文本，将其合并，并将结果保存到 `.txt` 文件中。这种技术通常用于文档摘要工具，您可能希望提取文档的引言和结尾。 [使用许可证密钥](https://ironsoftware.com/csharp/ppt/get-started/license-keys/)来解锁功能的方式类似，`Paragraphs`集合可让您访问特定的文档元素。 ```csharp :path=/static-assets/word/content-code-examples/how-to/extract-text-paragraphs.cs ``` 结合文档分析要求，提取特定段落的能力变得非常强大。 例如，您可以根据格式、位置或内容模式提取关键段落。 这种选择性提取方法有助于缩短处理时间，并将重点放在最相关的内容上。

从第一段中提取了哪些内容？

从最后一段中提取了哪些内容？

合并后的文本如何显示在输出文件中？

上面的截图显示了第一段提取、最后一段提取以及保存到文本文件中的合并输出。请注意，提取过程保留了文本内容，同时删除了格式信息，使其适合纯文本处理。

如何从 DOCX 表格中提取数据？ 表格通常包含需要提取进行处理或分析的结构化数据。 IronWord 允许您通过浏览行和单元格来访问表格数据。 在这个例子中，我们加载一个包含 API 统计信息的文档，并从第 2 行第 4 列提取一个特定的单元格值。 表格提取对于数据迁移项目、报告生成和自动数据收集工作流至关重要。 在处理表格数据时，理解基于零的索引系统至关重要--第一个表格是 `Tables[0]`，第一行是 `Rows[0]`，以此类推。 这种类似于 [ 许可](https://ironsoftware.com/csharp/ppt/licensing/)结构的系统化方法提供了可预测的访问模式。 ```csharp :path=/static-assets/word/content-code-examples/how-to/extract-text-table.cs ```

源表是什么样的？

从表格单元格中获取什么值？

## 高级文本提取场景 在处理复杂文档时，您可能需要结合多种提取技术。 下面的示例演示了从多个元素中提取文本并进行不同处理的过程： ```csharp using IronWord; using System.Text; using System.Linq; // Load a complex document WordDocument complexDoc = new WordDocument("report.docx"); // Create a StringBuilder for efficient string concatenation StringBuilder extractedContent = new StringBuilder(); // Extract and process headers (assuming they're in the first few paragraphs) var headers = complexDoc.Paragraphs .Take(3) .Select(p => p.ExtractText()) .Where(text => !string.IsNullOrWhiteSpace(text)); foreach (var header in headers) { extractedContent.AppendLine($"HEADER: {header}"); } // Extract table summaries foreach (var table in complexDoc.Tables) { // Get first cell as table header/identifier string tableIdentifier = table.Rows[0].Cells[0].ExtractText(); extractedContent.AppendLine($"\nTABLE: {tableIdentifier}"); // Extract key metrics (last row often contains totals) if (table.Rows.Count > 1) { var lastRow = table.Rows.Last(); var totals = lastRow.Cells.Select(cell => cell.ExtractText()); extractedContent.AppendLine($"Totals: {string.Join(", ", totals)}"); } } // Save the structured extraction System.IO.File.WriteAllText("structured-extract.txt", extractedContent.ToString()); ``` 这个高级示例展示了如何通过组合不同的文档元素来创建结构化提取。 这种方法适用于生成文档摘要、创建索引或准备进一步处理的数据。 正如[升级](https://ironsoftware.com/csharp/ppt/licensing/upgrades/)可以增强软件功能一样，结合提取方法可以增强您的文档处理能力。 ## 文本提取的最佳实践 在生产应用程序中实施文本提取时，请考虑以下最佳实践： 1.**错误处理**：始终用 try-catch 块封装提取代码，以处理可能损坏或具有意外结构的文档。 2.**性能优化**：对于大型文档或批量处理，可考虑只提取必要的部分，而不是整个文档内容。 3.**字符编码**：保存提取的文本时要注意字符编码，尤其是包含特殊字符或多种语言的文档。 4.**内存管理**：在处理多个文档时，请正确处理 `WordDocument` 对象，以防止内存泄漏。 请记住，文本提取会保留逻辑阅读顺序，但会删除格式。 如果您需要维护格式化信息，请考虑使用额外的 `IronWord` 功能或单独存储元数据。 对于生产部署，请查看 [更新日志](https://ironsoftware.com/csharp/ppt/product-updates/changelog/)，了解最新功能和改进。 ## 摘要 IronWord 的 `ExtractText()` 方法为从 DOCX 文件中提取文本提供了一种强大而灵活的方法。 无论您需要提取整个文档、特定段落还是表格数据，API 都能提供直接的方法来实现您的目标。 通过将这些技术与适当的错误处理和优化策略相结合，您可以构建强大的文档处理应用程序，有效处理各种文本提取场景。 如需了解更高级的应用场景和探索其他功能，请查看 [ 扩展工具](https://ironsoftware.com/csharp/ppt/licensing/extensions/) 和其他文档资源，以增强您的文档处理能力。