CreateDataRegion

创建一个新的数据区域，并返回 DataRegionWriter 对象。

调用此方法可以轻松地在指定的数据区域之前或之后创建新的数据区域并对新数据区域赋值或控制。

RelativeDataRegionName一般是文档中已存在的用户已预先定义的数据区域，但是RelativeDataRegionName还可以使用PageOffice开发平台预留的两个特殊数据区域：[HOME]和[END]。 [HOME]和[END]不需用户打开文档手动定义，它们分别代表文档的开始光标位置和结束光标位置。

如果当前文档是空白文档，一个数据区域都不存在，使用[HOME]和[END]可以从空白文档生成一个图文并茂的格式文档。

语法：

public DataRegionWriter CreateDataRegion(
        string NewDataRegionName,
        DataRegionInsertType InsertType,
        string RelativeDataRegionName
    )

参数：

NewDataRegionName - 新建 DataRegion 的名称。注意：应当确保不与文档中已存在的数据区域同名。

InsertType - 新建 DataRegion 的插入方式。

RelativeDataRegionName - 相对 DataRegion 的名称。

返回：

返回 DataRegionWriter 对象。

示例：

下面的示例展示如何调用 CreateDataRegion 方法创建新的数据区域，并且填充数据到新的数据区域。新数据区域"NewProductName"位于"ProductName"数据区域之前。

在运行本代码前，请手动打开test.doc文档，在相应的位置处插入书签"PO_CompanyName" 和 "PO_ProductName"。

PageOfficeNetCore.Word.WordDocumentWriter doc = new PageOfficeNetCore.Word.WordDocumentWriter();

doc.OpenDataRegion("CompanyName").Value = "卓正软件";
doc.OpenDataRegion("ProductName").Value = "PageOffice";
PageOfficeNetCore.Word.DataRegionWriter drNewProduct = doc.CreateDataRegion("NewProductName", PageOfficeNetCore.Word.DataRegionInsertType.Before, "ProductName");
drNewProduct.Value = "卓正ZoomSeal电子签章系统";

PageOfficeNetCore.PageOfficeCtrl POCtrl = new PageOfficeNetCore.PageOfficeCtrl(Request);
POCtrl.SetWriter(doc);
POCtrl.WebOpen("doc/test.doc", PageOfficeNetCore.OpenModeType.docReadOnly, "张三"); //只读打开