当前位置：首页 > news >正文

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

news 2025/11/14 6:07:06

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

安装 Spire.Doc for .NET

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

PM> Install-Package Spire.Doc

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

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

示例代码如下：

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，即可将文本替换模式更改为仅替换首次出现的目标文本。

示例代码如下：

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 中，可以通过在目标文本的位置插入图片，然后从文档中删除该文本，从而实现将文本替换为图片的效果。

示例代码如下：

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() 方法可以利用正则表达式来搜索特定文本，从而根据特定条件执行高级的查找和替换操作。

示例代码如下：

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();}}
}