数据标签填充文本并设置样式
# 数据标签填充文本并设置样式
- 查看本示例演示效果(Windows版)
- 查看本示例演示效果(国产版)
- 本示例关键代码的编写位置,请参考“开始 - 快速上手”里您所使用的开发语言框架的最简集成代码
注意
本文中展示的代码均为关键代码,复制粘贴到您的项目中,按照实际的情况,例如文档路径,用户名等做适当修改即可使用。
在实际项目涉及到Word文档的开发中,常常会遇到希望自动填充各项数据到Word模板中,并且针对模板中有多处位置需要同一数据,动态生成Word文档的需求。比如说生成一份合同(有多个位置需要填充甲乙双方公司名称),数据库表已经保存了甲乙双方的资料信息,设计好一个合同模板docx,用代码读取数据库字段把甲乙双方信息填充到Word模板中自动生成合同。通过调用PageOffice操作数据标签的对象,就可以实现此目的。
# DataRegion与DataTag的区别
DataRegion与DataTag都是为了实现动态填充模版生成文件而开发的,但是二者又有所不同,各自有着自身的优势与特点。
DataRegion 既可手动通过Office工具栏中的“插入”→“书签”,向Word模版中插入书签(书签需以“PO_”开头,且不可重名,两个书签之间要有最少一个的有效字符),又可通过程序动态在Word模版中某些插入书签,书签的插入方式更加的灵活和自由。
DataTag 只能提前在Word模版中手动插入,但是在模版中插入DataTag的方法更加的简单和方便,可直接在要动态填充数据的地方手动输入自定义的、有特殊标示的字符串,而无需通过工具栏插入书签,但是目前DataTag不支持通过程序向Word模版中动态插入。
综上所述,在动态填充数据时可根据实际情况将两者结合使用,文档中多个位置需要填充同一数据时用DataTag,一个数据只填充到一个位置时使用DataRegion,这两者相辅相成能更加完善地实现Word文件数据的动态填充。

然后,编写代码打开template1.docx文件,并动态填充数据。
# 后端代码
PageOfficeCtrl poCtrl = new PageOfficeCtrl(request);
WordDocumentWriter wd = new WordDocumentWriter();
wd.openDataTag("{甲方公司名称}").setValue("北京甲测试公司");
wd.openDataTag("{乙方公司名称}").setValue("北京乙测试公司");
DataTagWriter dateTag = wd.openDataTag("{日期}");
dateTag.setValue(new SimpleDateFormat("yyyy-MM-dd").format(new Date()).toString());
dateTag.getFont().setColor(Color.RED); //设置文字颜色。 还可以设置字体、粗细、斜体、字号等样式。
poCtrl.setWriter(wd); //必须
poCtrl.webOpen("D:\\template1.docx", OpenModeType.docNormalEdit, "张佚名");
PageOfficeNetCore.PageOfficeCtrl poCtrl = new PageOfficeNetCore.PageOfficeCtrl(Request);
PageOfficeNetCore.Word.WordDocumentWriter worddoc = new PageOfficeNetCore.Word.WordDocumentWriter();
worddoc.OpenDataTag("{甲方公司名称}").Value = "北京甲测试公司";
worddoc.OpenDataTag("{乙方公司名称}").Value = "北京乙测试公司";
PageOfficeNetCore.Word.DataTagWriter dateTag = worddoc.OpenDataTag("{日期}");
dateTag.Value = DateTime.Now.ToString("yyyy-MM-dd");
dateTag.Font.Color = Color.Blue; //设置文字颜色。 还可以设置字体、粗细、斜体、字号等样式。
poCtrl.SetWriter(worddoc);//必须。
poCtrl.WebOpen("D:\\template1.docx", PageOfficeNetCore.OpenModeType.docNormalEdit, "tom");
// Make sure to add code blocks to your code group
# 前端代码
本示例无前端关键代码。
上次更新: 2025/07/21, 15:21:36