## **DataRegion类** DataRegion 类，代表一个数据区域，用来填充数据区域及控制数据区域格式。您只能通过调用 OpenDataRegion(String) 方法或 CreateDataRegion(String, DataRegionInsertType, String) 方法获得 DataRegion 对象。 >[info] 什么是数据区域？数据区域是Word文档中具有 "PO_" 前缀命名的书签所定位的文档区域。简单来说，数据区域就是一种特殊的Word书签对象，便于定位Word文档中的内容。**数据区域是PageOffice开发平台中重要的技术概念，很多Word操作都需要调用DataRegion完成。** 这里举个简单的例子说明什么是数据区域：假设开发者需要在待打开的Word文档指定位置处显示产品名称，就可以先手动打开此Word文档，在指定位置处插入书签"PO_ProductName"，保存文档。这样数据区域"ProductName"就定义好了，编写代码即可在此数据区域处生成想要的内容。 ~~~ doc.openDataRegion("PO_ProductName").setValue("PageOffice"); ~~~ ### **所属命名空间：** -------------- **进行写入操作时** Java开发时命名空间为：com.zhuozhengsoft.pageoffice.wordwriter ASP.NET开发时命名空间为：PageOffice.WordWriter **进行读取操作时** Java开发时命名空间为：com.zhuozhengsoft.pageoffice.wordreader ASP.NET开发时命名空间为：PageOffice.WordReader ### **WordDocument类的使用** --------------------------- WordDocument类在PageOffice开发平台下，通过PageOfficeCtrl控件实现对Word文件的写入和读取操作。 部分实现代码如下： **JAVA写入操作：** ~~~ // WordDocument对象的创建 WordDocument doc = new WordDocument(); DataRegion dataRegion = doc.openDataRegion("PO_Name");//打开数据区域 dataRegion.setValue("张三"); ... ... poCtrl1.setWriter(doc); //设置数据对象，不要忘记此句，否则向Word中写入的操作不起作用 poCtrl1.setSaveDataPage("SaveDate.jsp");//保存时接收数据的地址 poCtrl1.webOpen("doc/test.doc", OpenModeType. docNormalEdit, "用户名");//打开文件 ~~~ **JAVA读取操作：** ~~~ 获取Word提交的数据 // WordDocument对象的创建 WordDocument doc = new WordDocument(request,response); DataRegion dataRegion = doc.openDataRegion("PO_Name");//获取某个数据区域 String name = dataRegion.getValue();//获取数据区域中的数据 ... ... doc.close();//关闭WordDocument对象并返回保存成功的消息。 ~~~ **ASP.NET写入操作：** ~~~ // WordDocument对象的创建 PageOffice.WordWriter.WordDocument doc = new PageOffice.WordWriter.WordDocument(); PageOffice.WordWriter.DataRegion dataRegion = doc.OpenDataRegion("PO_Name");//打开数据区域 dataRegion.Value = "张三"; ... ... PageOfficeCtrl1.SetWriter(doc);//设置数据对象，不要忘记此句，否则向Word中写入的操作不起作用 PageOfficeCtrl1.SaveDataPage = "SaveData.aspx";//保存时接收数据的地址 PageOfficeCtrl1.WebOpen("doc/test.doc",PageOffice.OpenModeType.docNormalEdit,"用户名"); ~~~ **ASP.NET读取操作：** ~~~ // WordDocument对象的创建 WordDocument doc = new WordDocument(); DataRegion dataRegion = doc.OpenDataRegion("PO_Name"); string name = dataRegion.Value;//获取数据区域中的数据 ... ... doc.Close(); ~~~