C#通过模板生成Word文档并替换文本与图片占位符的完整攻略

更新时间：2026年07月09日 08:35:37 作者：秋天的落叶铺满小路

在办公自动化开发中,根据固定模板批量生成 Word 文档是最常见的需求之一,本文将介绍如何使用 Spire.Doc for .NET 组件,通过加载模板文件,将文档中的文本占位符替换为真实数据,并支持将占位符替换为图片,希望对大家有所帮助

在办公自动化开发中，根据固定模板批量生成 Word 文档（如合同、报告、简历、通知书等）是最常见的需求之一。本文将介绍如何使用 Spire.Doc for .NET 组件，通过加载模板文件，将文档中的文本占位符替换为真实数据，并支持将占位符替换为图片，最终生成一份完整的 Word 文档。

为什么选择 Spire.Doc

Spire.Doc 是一款功能强大的 .NET Word 组件，无需安装 Microsoft Office 即可创建、读取、编辑和转换 Word 文档。它提供了丰富的 API，尤其 Document.Replace() 方法可以快速完成文本替换，而结合 FindString() 与 DocPicture 又能灵活实现图片插入，非常适合模板填充场景。

代码实现步骤

下面通过一个完整的控制台程序示例，演示如何将模板中的 #name#、#gender# 等占位符替换为实际内容，并将 #photo# 替换为一张图片。

1. 引入命名空间与初始化文档

using Spire.Doc;
using Spire.Doc.Documents;
using Spire.Doc.Fields;
using System.Drawing;

创建 Document 对象并加载模板文件（.docx）：

Document document = new Document();
document.LoadFromFile("Template.docx");

2. 文本占位符替换

建立一个字典，键为占位符（如 #name#），值为真实数据。这里我们将示例内容本地化为中文环境：

Dictionary<string, string> replaceDict = new Dictionary<string, string>
{
    { "#name#", "张三" },
    { "#gender#", "男" },
    { "#birthdate#", "1990年1月15日" },
    { "#address#", "上海市浦东新区" },
    { "#city#", "上海" },
    { "#state#", "直辖市" },
    { "#postal#", "200120" },
    { "#country#", "中国" }
};

遍历字典，调用 document.Replace(占位符, 替换值, true, true) 完成全文档替换。后两个布尔参数分别表示是否区分大小写和是否匹配整个单词，这里按需设置。

3. 图片占位符替换

文本替换无法处理图片，因此我们需要单独实现一个方法 ReplaceTextWithImage。其核心逻辑是：

用 Image.FromFile() 加载图片；
创建 DocPicture 对象并载入图片；
通过 document.FindString() 定位占位符 #photo# 所在的 TextRange；
获取该 TextRange 在段落子对象中的索引，将图片插入同一位置，然后删除占位符文本。

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

调用时传入图片路径：

ReplaceTextWithImage(document, "#photo#", "portrait.png");

4. 保存与释放

最后将文档保存为新文件，并释放资源：

document.SaveToFile("ReplacePlaceholders.docx", FileFormat.Docx);
document.Dispose();

完整代码一览

using Spire.Doc;
using Spire.Doc.Documents;
using Spire.Doc.Fields;
using System.Drawing;

namespace CreateWordByReplacingTextPlaceholders
{
    class Program
    {
        static void Main(string[] args)
        {
            Document document = new Document();
            document.LoadFromFile("Template.docx");

            Dictionary<string, string> replaceDict = new Dictionary<string, string>
            {
                { "#name#", "张三" },
                { "#gender#", "男" },
                { "#birthdate#", "1990年1月15日" },
                { "#address#", "上海市浦东新区" },
                { "#city#", "上海" },
                { "#state#", "直辖市" },
                { "#postal#", "200120" },
                { "#country#", "中国" }
            };

            foreach (var kvp in replaceDict)
            {
                document.Replace(kvp.Key, kvp.Value, true, true);
            }

            ReplaceTextWithImage(document, "#photo#", "portrait.png");

            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 模板中，占位符必须与代码中的字符串完全一致（包括大小写和特殊符号），建议使用明显的标记如 # 或 {{}} 以避免误替换。
图片处理 ：ReplaceTextWithImage 方法假设占位符独立存在于一个段落中，若占位符与其他文本同行，插入图片后可能会影响排版，可根据业务调整插入位置。
性能优化 ：对于大量文档生成，可复用 Document 对象，或使用内存流操作。
字体与样式 ：替换文本后，新内容会继承原占位符的样式，如需自定义样式，可操作 TextRange 的 CharacterFormat 属性。

总结

通过 Spire.Doc 提供的简洁 API，我们仅用几十行代码就实现了 Word 模板的数据填充，既支持文本又支持图片。这种方式极大地提高了文档生成的效率和准确性，非常适合企业级报表、证书打印、批量信函等场景。开发者只需关注模板设计和数据来源，剩下的交给代码即可。

如果你正在寻找轻量级、无 Office 依赖的 Word 操作方案，Spire.Doc 无疑是一个值得尝试的选择。希望本文能帮助你快速上手，为你的项目增添自动化生成文档的能力。

到此这篇关于C#通过模板生成Word文档并替换文本与图片占位符的完整攻略的文章就介绍到这了,更多相关C#模板生成Word文档内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

C#
Word

C#保存与读取DataTable信息到XML格式的方法
这篇文章主要介绍了C#保存与读取DataTable信息到XML格式的方法,实例分析了C#读取DataTable信息到XML格式及读取XML格式数据到DataTable的相关技巧,具有一定参考借鉴价值,需要的朋友可以参考下
2015-08-08
基于C#实现ModbusTCP服务器接口的方法
ModbusTCP服务器的本质就是TCP服务器,根据识别ModbusTCP请求报文,返回对应的ModbusTCP报文,今天给大家分享一下,如何基于C#来ModbusTCP服务器接口,需要的朋友可以参考下
2025-01-01
基于WPF实现颜色选择器控件
这篇文章主要介绍了如何基于WPF实现简单的颜色选择器控件,文中的示例代码讲解详细,对我们学习或工作有一定帮助,需要的小伙伴可以参考一下
2023-08-08
Unity实现攻击范围检测并绘制检测区域
这篇文章主要介绍了Unity实现攻击范围检测并绘制检测区域，文中示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
2020-04-04
c#实现摄像头拍照功能示例
这篇文章主要介绍了c#实现摄像头拍照功能示例,需要的朋友可以参考下
2014-04-04
C#实现HTTP访问类HttpHelper的示例详解
在项目开发过程中，我们经常会访问第三方接口，如我们需要接入的第三方接口是Web API,这时候我们就需要使用HttpHelper调用远程接口了。本文为大家介绍了C#实现HTTP访问类HttpHelper的示例代码，需要的可以参考一下
2022-09-09
WPF使用Geometry绘制几何图形
这篇文章介绍了WPF使用Geometry绘制几何图形的方法，文中通过示例代码介绍的非常详细。对大家的学习或工作具有一定的参考借鉴价值，需要的朋友可以参考下
2022-06-06
C#判断网站是否能访问或者断链的方法
这篇文章主要介绍了C#判断网站是否能访问或者断链的方法,实例分析了C#判断网站是否能访问的相关技巧,具有一定参考借鉴价值,需要的朋友可以参考下
2015-07-07
C#在foreach遍历删除集合中元素的三种实现方法
这篇文章主要给大家总结介绍了关于C#在foreach遍历删除集合中元素的实现方法，文中通过示例代码介绍的非常详细，对大家学习或者使用C#具有一定的参考学习价值，需要的朋友们下面来一起学习学习吧
2019-12-12
WinFrom中label背景透明的实现方法
这篇文章主要介绍了WinFrom中label背景透明的实现方法,方法简单实用,是C#程序设计中非常实用的技巧,需要的朋友可以参考下
2014-09-09