PageOffice，word常用接口对象--DataRegion类

DataRegion 类，代表一个数据区域，用来填充数据区域及控制数据区域格式。您只能通过调用 OpenDataRegion(String) 方法或 CreateDataRegion(String, DataRegionInsertType, String) 方法获得 DataRegion 对象。

什么是数据区域？数据区域是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();