如何在 C# 中用表格替换 Word 文档中的文本？

在日常的文档处理工作中，我们经常会遇到这样的场景：需要将 Word 文档中的特定文本内容，例如一份报告中的数据占位符"##数据列表##"，替换为结构化的实际数据表格。使用Spire.Doc for .NET库，我们可以通过精准定位文本并利用其强大的替换功能，轻松实现将文本替换为格式化表格，从而高效生成定制化的报告或文档。

为什么需要将文本替换为表格？

将 Word 文档中的文本替换为表格，并非简单的格式转换，它在许多实际应用场景中都展现出极高的价值：

自动化报告生成：设想您需要从数据库中提取数据，并将其填充到预设的 Word 报告模板中。如果模板中包含"##销售数据##"这样的占位符，通过程序将其替换为包含具体销售明细的表格，将大大提高报告生成的效率和准确性。
模板填充与内容规范化：在合同、协议、产品说明书等文档中，经常需要将特定的信息点（如"[客户信息]"、"[产品参数]"）替换为标准化的表格，以确保信息的完整性和一致性。
数据可视化与结构化呈现：对于某些非结构化的文本描述，将其转换为表格形式，能够更清晰、直观地展示数据间的关系，提升文档的可读性。

手动操作这些任务，不仅耗时耗力，而且容易因疏忽导致数据错漏，无法满足高并发、批量处理的需求。因此，寻求一种编程自动化解决方案显得尤为重要。

选择合适的工具：Spire.Doc for .NET

要在 C# 中高效处理 Word 文档，特别是进行复杂的查找和替换操作，选择一个功能强大且易于使用的第三方库是关键。

Spire.Doc for .NET 作为一个专业的 Word 文档组件，它允许开发者在 .NET 应用程序中创建、读取、写入、修改、转换和打印 Word 文档，而无需安装 Microsoft Word。其主要优势包括：

功能强大：支持 Word 文档的各种操作，包括文本、图片、表格、段落、样式、书签等，甚至支持复杂的文档结构和格式。
API 友好：提供了直观且易于理解的 API 接口，开发者可以快速上手并集成到自己的项目中。
高效稳定：在处理大型文档和批量操作时表现出色，能够保证数据处理的稳定性和准确性。
广泛支持：兼容 .NET Framework、.NET Core、.NET Standard 等多种 .NET 平台。

安装方法 ：您可以通过 NuGet 包管理器轻松安装 Spire.Doc for .NET。在 Visual Studio 中，右键点击项目 -> "管理 NuGet 包"，搜索 Spire.Doc 并安装即可。

C# 代码实战：文本替换为表格的详细步骤

接下来，我们将通过一个具体的 C# 代码示例，详细演示如何将 Word 文档中的特定文本替换为表格。

假设我们有一个 Word 文档，其中包含占位符 [DATA_TABLE_PLACEHOLDER]，我们希望将其替换为一个包含具体数据的表格。

csharp 复制代码

using Spire.Doc;
using Spire.Doc.Documents;
using Spire.Doc.Fields;
using System.Drawing; // 用于颜色
using System.Collections.Generic; // 用于List

public class ReplaceTextWithTable
{
    public static void Main(string[] args)
    {
        // 1. 加载Word文档
        // 创建一个Document对象并加载现有Word文档
        Document document = new Document();
        document.LoadFromFile("Input.docx"); // 替换为你的Word文档路径

        // 定义要查找的文本占位符
        string placeholder = "[DATA_TABLE_PLACEHOLDER]";

        // 查找所有占位符的位置
        TextSelection[] textSelections = document.FindAllString(placeholder, true, true);

        // 为了避免在替换过程中索引失效，我们从后往前处理，或者先收集所有位置再统一处理
        // 这里我们选择先收集位置信息，然后按照文档顺序进行替换
        // 注意：直接使用 Replace 方法替换为表格会比较复杂，
        // Spire.Doc 提供了更灵活的方式：找到占位符所在的段落，插入表格，然后删除占位符。

        // 收集所有需要替换的文本范围及其所在段落
        List<TextRangeLocation> locations = new List<TextRangeLocation>();
        foreach (TextSelection selection in textSelections)
        {
            locations.Add(new TextRangeLocation(selection.GetAsOneRange()));
        }
        // 按文档顺序排序，以确保替换的逻辑正确性
        locations.Sort(); // TextRangeLocation 实现了 IComparable，按文档位置排序

        // 从后往前遍历，避免替换后文档结构变化影响后续查找的索引
        for (int i = locations.Count - 1; i >= 0; i--)
        {
            TextRangeLocation location = locations[i];
            Paragraph ownerParagraph = location.Owner;
            TextBody ownerBody = ownerParagraph.OwnerTextBody;
            int paragraphIndex = ownerBody.ChildObjects.IndexOf(ownerParagraph);
            int textRangeIndex = ownerParagraph.ChildObjects.IndexOf(location.Text);

            // 2. 创建并填充表格
            Table newTable = CreateSampleTable(document);

            // 3. 将表格插入到目标文本位置并删除原文本
            // 插入表格到占位符所在的段落之前
            ownerBody.ChildObjects.Insert(paragraphIndex, newTable);

            // 删除原始占位符文本
            // 如果占位符是段落的唯一内容，可以直接删除段落
            // 否则，只删除文本范围
            if (ownerParagraph.ChildObjects.Count == 1 && ownerParagraph.ChildObjects[0] == location.Text)
            {
                ownerBody.ChildObjects.Remove(ownerParagraph);
            }
            else
            {
                ownerParagraph.ChildObjects.Remove(location.Text);
                // 如果删除文本后，段落变空，也可以考虑删除段落
                if (ownerParagraph.ChildObjects.Count == 0)
                {
                     ownerBody.ChildObjects.Remove(ownerParagraph);
                }
            }
        }

        // 4. 保存修改后的文档
        document.SaveToFile("OutputWithTable.docx", FileFormat.Docx2013);
        System.Diagnostics.Process.Start("OutputWithTable.docx"); // 打开查看结果
    }

    /// <summary>
    /// 创建一个示例表格
    /// </summary>
    private static Table CreateSampleTable(Document document)
    {
        Table table = new Table(document);
        table.TableFormat.Borders.LineWidth = 1; // 设置表格边框
        table.TableFormat.Borders.BorderType = BorderStyle.Single;

        // 添加表头
        TableRow headerRow = table.AddRow(true); // true 表示是表头行
        headerRow.RowFormat.BackColor = Color.LightGray; // 背景色
        headerRow.Cells[0].AddParagraph().AppendText("姓名").CharacterFormat.Bold = true;
        headerRow.Cells[1].AddParagraph().AppendText("年龄").CharacterFormat.Bold = true;
        headerRow.Cells[2].AddParagraph().AppendText("城市").CharacterFormat.Bold = true;

        // 添加数据行
        AddDataRow(table, "张三", "30", "北京");
        AddDataRow(table, "李四", "25", "上海");
        AddDataRow(table, "王五", "35", "广州");

        return table;
    }

    /// <summary>
    /// 辅助方法：向表格添加一行数据
    /// </summary>
    private static void AddDataRow(Table table, params string[] cellTexts)
    {
        TableRow dataRow = table.AddRow(false); // false 表示不是表头行
        for (int i = 0; i < cellTexts.Length; i++)
        {
            dataRow.Cells[i].AddParagraph().AppendText(cellTexts[i]);
        }
    }

    /// <summary>
    /// 辅助类：用于存储 TextRange 的位置信息，便于排序和处理
    /// </summary>
    public class TextRangeLocation : IComparable<TextRangeLocation>
    {
        public TextRange Text { get; set; }
        public Paragraph Owner { get; set; }
        public int Index { get; set; } // TextRange 在其 OwnerParagraph 中的索引

        public TextRangeLocation(TextRange text)
        {
            this.Text = text;
            this.Owner = text.OwnerParagraph;
            this.Index = this.Owner.ChildObjects.IndexOf(text);
        }

        public int CompareTo(TextRangeLocation other)
        {
            // 比较 TextBody 中的段落索引
            int paragraphCompare = this.Owner.OwnerTextBody.ChildObjects.IndexOf(this.Owner)
                                   .CompareTo(other.Owner.OwnerTextBody.ChildObjects.IndexOf(other.Owner));

            if (paragraphCompare != 0)
            {
                return paragraphCompare; // 如果段落不同，按段落顺序排序
            }
            else
            {
                // 如果是同一个段落，按 TextRange 在段落中的索引排序
                return this.Index.CompareTo(other.Index);
            }
        }
    }
}

代码解析：

加载 Word 文档 ：使用 document.LoadFromFile() 方法加载待处理的 Word 文档。
查找目标文本 ：document.FindAllString(placeholder, true, true) 方法用于查找所有匹配指定占位符的文本。true, true 表示区分大小写和全字匹配。
创建并填充表格 ：CreateSampleTable 方法演示了如何构建一个 Spire.Doc 的 Table 对象，并添加表头和数据行。您可以根据实际需求动态生成表格内容和格式。
插入表格与删除文本：这是核心步骤。
- 我们首先获取占位符所在的 Paragraph 和 TextBody（通常是 Section.Body）。
- 通过 ownerBody.ChildObjects.Insert(paragraphIndex, newTable) 将新创建的表格插入到占位符所在段落的前面。
- 然后，通过 ownerParagraph.ChildObjects.Remove(location.Text) 删除原始的占位符文本。这里需要注意处理占位符是段落唯一内容的情况。
- 为了正确处理多个占位符，我们先收集所有位置，然后从后往前遍历替换，避免因删除或插入内容导致后续索引失效。
保存文档 ：document.SaveToFile() 方法将修改后的文档保存到新文件。