使用C#代码在 Word 文档中查找并替换文本

在编辑文档时，更改文本是一项常见的任务。Microsoft Word 提供了一个功能强大的"查找和替换"功能，可以简化文本编辑过程。通过此功能，您可以轻松地在文档中定位特定的单词、短语或字符，并在一次操作中将它们替换掉。这样就无需重复手动查找和修改，从而节省大量时间和精力，特别是在需要对长篇文档进行大范围修改时。本文将介绍如何使用 Spire.Doc for .NET 在 C# 中实现 Word 文档中的查找与替换功能。

安装 Spire.Doc for .NET

首先，您需要在 .NET 项目中添加 Spire.Doc for .NET 包中包含的 DLL 文件作为引用。您可以通过以下两种方式获取这些 DLL 文件：从官方网站链接下载，或通过 NuGet 进行安装。

cs 复制代码

PM> Install-Package Spire.Doc

查找文本并将其所有实例替换为新文本

Spire.Doc for .NET 提供了 Document.Replace() 方法，可用于在 Word 文档中查找并替换指定文本。通过此方法，您可以轻松地将目标文本的所有出现位置替换为新的内容。此外，您还可以灵活设置搜索是否区分大小写，以及是否仅匹配整个单词。

示例代码如下：

cs 复制代码

using Spire.Doc;
namespace ReplaceAllText
{
    internal class Program
    {
        static void Main(string[] args)
        {
            //实例化 Document 类的对象
            Document document = new Document();
            //加载示例 Word 文档
            document.LoadFromFile("Sample.docx");

            //将所有指定文本替换为新文本
            document.Replace("Spire.Doc", "Eiceblue", false, true);

            //保存结果文档
            document.SaveToFile("ReplaceAllText.docx", FileFormat.Docx2016);
            document.Close();
        }
    }
}

查找文本并将其首次出现的实例替换为新文本

要在 Word 文档中使用 Spire.Doc for .NET 替换指定文本的第一个实例，可以使用 Document.ReplaceFirst 属性。通过在调用 Document.Replace() 方法之前将该属性设置为 true，即可将文本替换模式更改为仅替换首次出现的目标文本。

示例代码如下：

cs 复制代码

using Spire.Doc;

namespace ReplaceFirstText
{
    internal class Program
    {
        static void Main(string[] args)
        {
            //创建 Document 类的对象
            Document document = new Document();
            //加载示例 Word 文档
            document.LoadFromFile("Sample.docx");

            //将文本替换模式更改为仅替换第一个匹配项
            document.ReplaceFirst = true;

            //将指定文本的第一个匹配项替换为新文本
            document.Replace("Spire.Doc", "Eiceblue", false, true);

            //保存结果文档
            document.SaveToFile("ReplaceFirstText.docx", FileFormat.Docx2016);
            document.Close();
        }
    }
}

查找并将文本替换为图片

有时，你可能需要将文本替换为图片，以便进行视觉展示或设计。在 .NET 版 Spire.Doc 中，可以通过在目标文本的位置插入图片，然后从文档中删除该文本，从而实现将文本替换为图片的效果。

示例代码如下：

cs 复制代码

using Spire.Doc;
using Spire.Doc.Documents;
using Spire.Doc.Fields;

namespace ReplaceTextWithImage
{
    internal class Program
    {
        static void Main(string[] args)
        {
            //创建 Document 类的对象
            Document document = new Document();
            //加载一个示例 Word 文档
            document.LoadFromFile("Sample.docx");

            //查找文档中指定的文本
            TextSelection[] selections = document.FindAllString("Spire.Doc", true, true);

            int index = 0;
            Paragraph ownerParagraph = null;

            //遍历所有匹配的文本
            foreach (TextSelection selection in selections)
            {
                //获取文本所在的段落
                ownerParagraph = selection.GetAsOneRange().OwnerParagraph;

                //获取文本在段落中的索引位置
                index = ownerParagraph.ChildObjects.IndexOf(selection.GetAsOneRange());

                //加载一张图片
                DocPicture pic = new DocPicture(document);
                pic.LoadImage("img.png");

                //在文本的位置插入图片
                ownerParagraph.ChildObjects.Insert(index, pic);

                //从段落中移除原文本
                ownerParagraph.ChildObjects.Remove(selection.GetAsOneRange());
            }

            //保存结果文档
            document.SaveToFile("ReplaceTextWithImage.docx", FileFormat.Docx2016);
            document.Close();
        }
    }
}

使用正则表达式查找并替换文本

正则表达式提供了一套强大的工具，用于在文档中执行复杂的查找和替换操作。Document.Replace() 方法可以利用正则表达式来搜索特定文本，从而根据特定条件执行高级的查找和替换操作。

示例代码如下：

cs 复制代码

using Spire.Doc;
using System.Text.RegularExpressions;

namespace ReplaceTextWithRegex
{
    internal class Program
    {
        static void Main(string[] args)
        {
            //创建 Document 类的对象
            Document document = new Document();
            //加载一个示例 Word 文档
            document.LoadFromFile("Sample.docx");

            //创建一个正则表达式，用于匹配以 # 开头的文本
            Regex regex = new Regex(@"\#\w+\b");

            //将匹配的文本替换为新文本
            document.Replace(regex, "Spire.Doc");

            //保存结果文档
            document.SaveToFile("ReplaceTextWithRegex.docx", FileFormat.Docx2016);
            document.Close();
        }
    }
}

申请临时许可证

如果你想移除生成文档中的评估信息，或解除功能限制，请为自己申请一个 30 天的试用许可证。