WebOpen
在线打开Office文档。
此方法是 PageOfficeCtrl 控件的重要方法,用来在线打开Office文档。
WebOpen 方法一般放在PageOfficeCtrl调用代码末尾处调用。
语法:
public void WebOpen(
string DocumentURL,
OpenModeType OpenMode,
string UserName
)
参数:
DocumentURL
- 待打开文档的URL地址。
此文档既可以是来自Web服务器文件夹的文件,也可以是用服务器页面动态输出的文件二进制流。但是必须保证文档具有Office文件格式。
如果是网站文件夹内的文件,就使用URL;如果是网站文件夹外的文件,可以直接使用磁盘文件路径,例如:"D:\documents\test.doc"。
PageOffice 支持很多Office文档格式,例如 .doc,.docx,.xls,.xlsx,.ppt,.pptx,.xml and .rtf 等。
这里的URL可以是相对于当前页面的相对地址,也可以是http开头的绝对地址。相对URL可以是相对于当前页面的地址,也可以是以"/"开头的相对于整个Web应用程序根的地址。
注意:如果URL采用http开头的绝对地址,您必须确保这个地址和当前页面同属于一个网站。
OpenMode
- 文档打开模式。请确保 OpenMode 与要打开的Office文档的文件格式保持一致。
UserName
- 操作当前文档的用户名。一般来说,UserName 应该采用登录到您的Web项目的当前用户的名称。
[!note] 如果是前后端分离的项目,documentURL使用相对地址时,是相对于后端项目的相对路径。
示例:
打开 test.doc 文档并把文档设置成可编辑状态。
PageOfficeNetCore.PageOfficeCtrl POCtrl = new PageOfficeNetCore.PageOfficeCtrl(Request);
//URL方式打开文档
POCtrl.WebOpen("doc/test.doc", PageOfficeNetCore.OpenModeType.docNormalEdit, "张三");
//服务器磁盘路径方式打开文档
POCtrl.WebOpen("D:\\documents\\test.doc", PageOfficeNetCore.OpenModeType.docNormalEdit, "张三");