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

Word处理控件Spire.Doc系列教程：C# 通过模板创建 Word 文档

ds 2025/5/6 17:13:37

在企业应用中，无论是生成报告、合同还是个性化信函，程序化创建 Word 文档都是常见需求。E-iceblue旗下Spire系列产品是国产文档处理领域的优秀产品，支持国产化，帮助企业高效构建文档处理的应用程序。Spire.Doc for .NET 提供了无需依赖 Microsoft Office 的 C# Word 文档处理解决方案。

本文将探讨两种基于模板生成文档的有效方法：

通过替换文本占位符创建Word文档
通过替换书签内容创建Word文档

.NET Word文档生成类库

Spire.Doc for .NET 是一款专业的 Word 文档处理 API，可帮助开发者实现多样化的文档操作功能。主要特性包括：

创建、读取、编辑和转换Word文档
支持DOC、DOCX、RTF等格式
基于模板的文档生成
邮件合并功能
保留原始格式

该库特别适用于需要保证一致性和效率的企业级文档自动化生成场景。

开始前，请从我们的官方网站下载 Spire.Doc for .NET，或通过 NuGet 包管理器使用以下命令进行安装：

PM> Install-Package Spire.Doc

通过替换文本占位符创建 Word 文档

Spire.Doc 库中的 Document.Replace 方法可用于查找替换 Word 文档中的特定文本，实现基于模板的动态文档生成。

通过替换文本生成Word文档的步骤如下：

1.文档初始化：创建 Document 对象并加载模板文件
2.占位符定义：使用字典映射占位符（如#name#）到替换值
3.文本替换：Document.Replace 方法执行区分大小写的全字匹配替换
4.图像处理：自定义 ReplaceTextWithImage 方法将文本占位符替换为图像
5.文档保存：将修改后的文档另存为新文件

using Spire.Doc;
using Spire.Doc.Documents;
using Spire.Doc.Fields;
using System.Drawing;namespace CreateWordByReplacingPlaceholders
{class Program{static void Main(string[] args){// 初始化一个新的 Document 对象Document document = new Document();// 加载模板 Word 文件document.LoadFromFile("C:\\Users\\Administrator\\Desktop\\template.docx");// 字典用于保存占位符及其替换内容Dictionary replaceDict = new Dictionary{{ "#name#", "张三" },{ "#gender#", "男" },{ "#birthdate#", "1990年3月20日" },{ "#address#", "金盆岭街道" },{ "#city#", "长沙" },{ "#province#", "湖南" },{ "#postal#", "410000" },{ "#country#", "中国" }};// 用相应的值替换文档中的占位符foreach (KeyValuePair kvp in replaceDict){document.Replace(kvp.Key, kvp.Value, true, true);}// 图像文件的路径String imagePath = "C:\\Users\\Administrator\\Desktop\\portrait.png";// 用图像替换照片占位符ReplaceTextWithImage(document, "#photo#", imagePath);// 保存修改后的文档document.SaveToFile("ReplacePlaceholders.docx", FileFormat.Docx);// 释放资源document.Dispose();}// 方法用于用图像替换文档中的占位符static void ReplaceTextWithImage(Document document, String stringToReplace, String imagePath){// 从指定路径加载图像Image image = Image.FromFile(imagePath);DocPicture pic = new DocPicture(document);pic.LoadImage(image);// 在文档中查找占位符TextSelection selection = document.FindString(stringToReplace, false, true);// 获取找到的文本范围TextRange range = selection.GetAsOneRange();int index = range.OwnerParagraph.ChildObjects.IndexOf(range);// 插入图像并移除占位符文本range.OwnerParagraph.ChildObjects.Insert(index, pic);range.OwnerParagraph.ChildObjects.Remove(range);}}
}

替换模板中的文本生成 Word

通过替换书签内容创建Word文档

Spire.Doc中的 BookmarksNavigator 类专门用于管理 Word 文档中的书签，该类提供了定位书签和替换书签内容的方法。

通过替换书签内容生成Word文档的步骤如下：

1.文档初始化：创建 Document 对象并加载模板文件
2.书签内容定义：创建书签名与替换内容的映射字典
3.书签导航：BookmarksNavigator 类精确定位书签位置
4.内容替换：ReplaceBookmarkContent 方法在更新内容时保留书签
5.文档保存：将修改后的文档另存为新文件

using Spire.Doc;
using Spire.Doc.Documents;namespace CreateWordByReplacingBookmarkContent
{class Program{static void Main(string[] args){// 初始化一个 Document 对象并加载模板Document document = new Document();document.LoadFromFile("C:\\Users\\Administrator\\Desktop\\template.docx");// 定义书签名称及其替换值Dictionary replaceDict = new Dictionary{{ "name", "Tech Innovations Inc." },{ "year", "2015" },{ "headquarter", "美国，纽约" },{ "history", "Tech Innovations Inc. 由一群工程师和企业家创立，他们的愿景是彻底改变技术行业。" +"公司最初专注于软件开发，后来将业务范围扩展到人工智能和云计算解决方案。" }};// 创建一个 BookmarksNavigator 来管理文档中的书签BookmarksNavigator bookmarkNavigator = new BookmarksNavigator(document);// 用相应的值替换每个书签的内容foreach (KeyValuePair kvp in replaceDict){bookmarkNavigator.MoveToBookmark(kvp.Key); // 导航到书签bookmarkNavigator.ReplaceBookmarkContent(kvp.Value, true); // 替换内容}// 保存修改后的文档document.SaveToFile("ReplaceBookmarkContent.docx", FileFormat.Docx2013);// 释放资源document.Dispose();}}
}

替换书签内容生成Word文档