世俱杯 2025

在企业应用中，无论是生成报告、合同还是个性化信函，程序化创建 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文档

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文档的方式，但有重要差异：

1.文本替换法：

• 永久移除占位符
• 适合一次性文档生成
• 更适合文本到图像的替换

2.书签替换法：

• 保留书签以便后续更新
• 适合需要定期更新的模板

此外，Spire.Doc for .NET 还支持邮件合并功能，这为从模板动态生成文档提供了另一种强大的方式。该功能特别适用于批量创建个性化文档，例如套用信函或报告，这些文档的数据通常来自数据库或其他结构化数据源。 

————————————————————————————————————————

关于慧都科技：

慧都科技是一家行业数字化解决方案公司，长期专注于软件、油气与制造行业。公司基于深入的业务理解与管理洞察，以系统化的业务建模驱动技术落地，帮助企业实现智能化运营与长期竞争优势。在软件工程领域，我们提供开发控件、研发管理、代码开发、部署运维等软件开发全链路所需的产品，提供正版授权采购、技术选型、个性化维保等服务，帮助客户实现技术合规、降本增效与风险可控。慧都科技E-iceblue的官方授权代理商，提供E-iceblue系列产品免费试用，咨询，正版销售等于一体的专业化服务。E-iceblue旗下Spire系列产品是国产文档处理领域的优秀产品，支持国产化，帮助企业高效构建文档处理的应用程序。

欢迎下载|体验更多E-iceblue产品