DataTagWriter
DataTagWriter 类,代表一个数据标签对象。
数据标签对象,代表Word文档中具有此特征字符串的所有文本区域。您只能通过调用 WordDocumentWriter.OpenDataTag 方法获得 DataTagWriter 对象。
什么是数据标签?数据标签是Word文档中用户插入的自定义特征文本。简单来说,数据标签就是具有一定特征的Word字符串文本,便于定位Word文档中的内容。
这里举个简单的例子说明什么是数据标签:假设开发者需要在待打开的Word文档指定位置处显示产品名称,就可以先手动打开此Word文档,在指定位置处插入文本"{ProductName}",保存文档。这样数据标签"{ProductName}"就定义好了。 编写如下代码:
doc.OpenDataTag("{ProductName}").Value = "PageOffice";
即可在此数据标签处生成想要的内容。
DataTag 和 DataRegion 的区别:DataRegion 的 Name 和Word文档中的位置是一一对应的;而 DataTag 的 Name 和Word文档中的位置是一对多的关系。也就是说,在Word文档中相同的特征字符串可以在多处出现, 而同一个Name的DataRegion只能表示Word文档中唯一一个位置。
所以DataTag的缺点是:DataTag只能用于填充文档内容,而DataRegion既可以填充文档内容,还可以创建文档内容、提交用户在DataRegion里输入的内容。 DataTag的优点是:DataTag可以在文档中多处生成需要重复的内容,而DataRegion无法简单重复,必须要设置不同的书签。应该用DataTag还是用DataRegion,视具体需求定。