C#替换Word文档中的书签内容的详细步骤

2025-08-02 10:21 开发作者： OfficeDocDevTeam

Word书签不但可以帮助读者快速跳转到想要查看的位置，而且可以用做“占位符”，程序员获取“占位符”之后，就可以更新这些“占位符”，即替换书签内容。替换模板文档中的书签内容，可以帮助我们快速生成Word报表或文档。

本文总结了一个将常见的Word文档元素（文字、图片和表格）替换进书签的C#解决方案，具体步骤见下文。

使用工具：

Spire.Doc.dll 6.4.5
Visual Studio 2013

步骤一制作模板

1. 新建Word文档

C#替换Word文档中的书签内容的详细步骤

图1 创建文档

2. 插入书签

C#替换Word文档中的书签内容的详细步骤

图2 插入书签

3. 保存模板，命名为“bookmark_template.docx”

C#替换Word文档中的书签内容的详细步骤

图3 保存模板文档

步骤二在项http://www.devze.com目中添加引用

1. 右键点击“解决方案资源管理”中的“引用”，选择“添加引用”

C#替换Word文档中的书签内容的详细步骤

图4 添加引用

2. 选择要引用的Spire.Doc.dll文件，添加至项目中

C#替换Word文档中的书签内容的详细步骤

图5 引用Spire.Doc.dll

步骤三编码

Spire.Doc提供了BookmarksNavigator类来获取和操作文档中的书签，但方法不是很直观。为了方便，我自己封装了Bookmark类，其中包括RepalceContent及其2个重载方法来分别应对插入文字、图片和表格三种情况。

public TextRange ReplaceContent(string bookmarkName, string text, bool saveFormatting)
public void ReplaceContent(string bookmarkName, string picPath, float widthScale, float heightScale, TextWrappingStyle wrapStyle, ShapeHorizontalAlignment horizontalAlignment)
public void ReplaceContent(string bookmarkName, Table table)

第一部分：Bookmark.cs编码

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

namespace ReplaceBookmarkContent
{
    class Bookmark
    {
        private Document doc = null;
        public Bookmark(Document document)
        {
            doc = document;
        }

        /// <summary>
        /// 用文本替换指定书签的内容
        /// </summary>
        /// <param name="bookmarkName">书签名</param>
        /// <param name="text">文本</param>
        /// <param name="saveFormatting">删除原始书签内容时，是否保留格式</param>
        /// <returns>TextRange</returns&编程gt;
        public TextRange ReplaceContent(string bookmarkName, string text, bool saveFormatting)
        {
            BookmarksNavigator navigator = new BookmarksNavigator(doc);
            navigator.MoveToBookmark(bookmarkName);//指向特定书签
            navigator.DeleteBookmarkContent(saveFormatting);//删除原有书签内容     
            Spire.Doc.Interface.ITextRange textRange = navigator.InsertText(text);//写入文本
            return textRange as TextRange;
        }

        /// <summary>
        /// 用图片替换指定书签的内容
        /// </su编程客栈mmary>
        /// <param name="bookmarkName">书签名</param>
        /// <param name="picPath">图片路径</param>
        /// &l编程t;param name="widthScale">宽度缩放比例，0以上正整数</param>
        /// <param name="heightScale">高度缩放比例，0以上正整数</param>
        /// <param name="wrapStyle">环绕方式</param>
        /// <param name="horizontalAlignment"></param>
        public void ReplaceContent(string bookmarkName, string picPath, float widthScale, float heightScale, TextWrappingStyle wrapStyle, ShapeHorizontalAlignment horizontalAlignment)
        {
            BookmarksNavigator navigator = new BookmarksNavigator(doc);
            navigator.MoveToBookmark(bookmarkName);
            navigator.DeleteBookmarkContent(false);
            IParagraphBase paragraphBase = navigator.InsertParagraphItem(ParagraphItemType.Picture);//插入类型为图片
            Image image = Image.FromFile(picPath);//加载图片
            DocPicture picture = paragraphBase.OwnerParagraph.AppendPicture(image);//插入图片
            picture.WidthScale = widthScale;
            picture.HeightScale = heightScale;
            picture.TextWrappingStyle = wrapStyle;
            picture.HorizontalAlignment = horizontalAlignment;
        }

        /// <summary>
        /// 用表格替换指定书签的内容
        /// </summary>
        /// <param name="bookmarkName">书签名</param>
        /// <param name="table">Table实例</param>
        public void ReplaceContent(string bookmarkName, Table table)
        {
            BookmarksNavigator navigator = new BookmarksNavigator(doc);
            navigator.MoveToBookmark(bookmarkName);
            TextBodyPart body = new TextBodyPart(doc);
            body.BodyItems.Add(table);
            navigator.ReplaceBookmarkContent(body);
        }

        /// <summary>
        /// 创建表格并写入数据，返回Table对象
        /// </summary>
        /// <param name="rowsNum">行数</param>
        /// <param name="columnsNum">列数</param>
        /// <param name="columnWidth">列宽</param>
        /// <param name="horizontalAlignment">水平对齐方式</param>
        /// <param name="datatable">DataTable实例</param>
        /// <returns></returns>
        public Table CreateTable(int rowsNum, int columnsNum, float columnWidth, RowAlignment horizontalAlignment, System.Data.DataTable datatable)
        {
            Table table = new Table(doc, true, 1f);//初始化Table对象
            table.ResetCells(rowsNum, columnsNum);//设置行数和列数
            //填充数据
            for (int i = 0; i < datatable.Rows.Count; i++)
            {
                for (int j = 0; j < datatable.Columns.Count; j++)
                {
                    table.Rows[i].Cells[j].AddParagraph().AppendText(datatable.Rows[i][j].ToString());
                }
            }
            //设置列宽
            for (int i = 0; i < rowsNum; i++)
            {
                for (int j = 0; j < columnsNum; j++)
                {
                    table.Rows[i].Cells[j].Width = columnWidth;
                }               
            }
            table.TableFormat.HorizontalAlignment = horizontalAlignment;//表格水平对齐方式
            return table;
        }
    }
}

第二步部分：生成文件的编码

//加载模板文档
Document doc = new Document();
doc.LoadFromFile(@"C:\Users\Administrator\Desktop\bookmark_template.docx");

//初始化Bookmark对象
Bookmark bookmark = new Bookmark(doc);

//用文本替换书签bookmark_text的内容
string text = "XXX科技股份有限公司成立于2010年12月，是一家致力于高新技术产品研发、生产、销售的高科技股份制企业，"
    + "公司坚持以技术创新为核心，以知识产权为基础，以人才战略为支撑，经过多年的砺练与发展，公司已逐步成以创新为引导的，"
    + "产品具有竞争力，人才素质优良的新兴科技企业。";
bookmark.ReplaceContent("bookmark_text", text, true);

//用图片替换书签bookmark_picture的内容
string picPath = @"C:\Users\Administrator\Desktop\company_logo.jpg";
bookmark.ReplaceContent("bookmark_picture", picPath, 80f, 80f, TextWrappingStyle.TopAndBottom, ShapeHorizontalAlignment.Center);

//创建模拟数据
DataTable dt = new DataTable();
dt.Columns.Add("employee_id", typeof(string));
dt.Columns.Add("name", typeof(string));
dt.Columns.Add("age", typeof(string));
dt.Columns.Add("sex", tjsypeof(string));
dt.Columns.Add("title", typeof(string));
dt.Rows.Add(new string[] {"工号", "姓名", "年龄", "性别", "职位" });
dt.Rows.Add(new string[] {"1023","Nancy", "28", "女", "Java程序员" });
dt.Rows.Add(new string[] { "1024","James", "34", "男", ".NET程序员" });
dt.Rows.Add(new string[] { "1025","Kobe", "38", "男", "系统管理员" });

//创建表格，并填充数据
Table table = bookmark.CreateTable(dt.Rows.Count, dt.Columns.Count, 100f, RowAlignment.Left, dt);

//用表格替换书签bookmark_table的内容
bookmark.ReplaceContent("bookmark_table", table);

//生成Word文件
doc.SaveToFile("output.docx", FileFormat.Docx2013);

运行代码，得到下面的结果：

C#替换Word文档中的书签内容的详细步骤

图6 生成的文件

注：

1. Spire.Doc本身也有Bookmark类，但仅用于添加书签到文档中，请注意本文中的Bookmark类是自定义的方便自己使用的方法的集合。

2. Spire.Doc 6.4.5 为商业版，在不应用许可证的情况下，生成的文档会有水印信息。笔者写文章时已应用临时许可证（官方提供的用于测试软件的License）。

3. 笔者使用免费版的Spire.Doc测试过，以上效果基本都能实现，但图片的环绕方式只能设置为“InLine”，且水平位置为靠右，设置其他环绕方式时，图片位置会出错。这应该是免费版的Bug。

到此这篇关于C#替换Word文档中的书签内容的详细步骤的文章就介绍到这了,更多相关C#替换Word书签内容内容请搜索编程客栈(www.devze.com)以前的文章或继续浏览下面的相关文章希望大家以后多多支持编程客栈(www.devze.com)！

继续阅读：C#替换Word C#替换Word书签内容 C#替换Word内容

C#替换Word文档中的书签内容的详细步骤

目录

步骤一制作模板

步骤二在项http://www.devze.com目中添加引用

步骤三编码

更多精彩内容

精彩评论

最新开发

C语言中%zu的用法解读