通过

为 Office 文件配置默认启动体验

  • 项目

配置 Office 客户端的启动模式

使用以下命令从 Microsoft 图形 API检索 DriveItem 时：

/graph/api/driveitem-get?view=graph-rest-1.0

webUrl响应中的 属性可以是指向 Web 应用程序开放平台接口 (WOPI) 的链接，用于呈现支持的 Office 文件类型。 URL 将如下所示：

https://host/:w:r/contentstorage/sitecollection/_layouts/15/doc2.aspx?sourcedoc=guid&file=filename.docx&action=default&mobileredirect=true

这将 webUrl 在默认模式下打开 WOPI (action=default) 。 如果要替代默认模式以强制特定模式 (例如，只读视图和编辑编辑器) ，可以如下进行扩充 webUrl ：

string webUrl = https://host/:w:r/contentstorage/sitecollection/_layouts/15/doc2.aspx?sourcedoc=guid&file=filename.docx&action=default&mobileredirect=true;

System.UriBuilder builder = new System.UriBuilder(webUrl);
System.Collections.Specialized.NameValueCollection queryDictionary = System.Web.HttpUtility.ParseQueryString(builder.Query);
queryDictionary["action"] = "view";
//queryDictionary["action"] = "edit";
builder.Query = queryDictionary.ToString();
string modifiedWebUrl = builder.ToString();

提示

若要了解有关 WOPI 操作的详细信息，请参阅： WOPI 发现 - WOPI 操作。

直接在桌面客户端中打开 Office 文件

若要直接在 Office 桌面客户端中打开文件，需要创建 Office URI 方案。 格式如下：

<scheme-name>:<command-name>"|"<command-argument-descriptor>"|"<command-argument>

使用下表替换前面的段：

  • scheme-name：应用程序的名称，例如： ms-excel
  • command-name：
    • ofv 用于打开文件视图
    • ofe 用于打开文件编辑
    • nft 对于“从模板新建”
  • command-argument-descriptor 和 command-argument：
    • |u|{file url}
    • |s|{save location}
      • 仅适用于“新建自模板”

注意

新建自模板可能无法按预期方式保存位置，因为权限架构不同于 SharePoint 网站。

下面包含 Office URI 方案的示例用法：

ms-word:ofv|u|https://contoso.com/document.docx
ms-powerpoint:ofe|u|https://contoso.com/presentation.pptx

由于 属性 webUrl 指向 Office Online for Office 文档，因此必须分两个步骤获取实际链接：

  1. 获取父文件夹的 WebUrl
  2. 追加文件的名称

例如，以下方案：

ms-word:ofe|u|{folder.WebUrl]/{item.Name}

...将生成以下方案：

ms-word:ofe|u|https://contoso.sharepoint.com/contentstorage/CSP_1234765465/Document%20Library/MyDocument.docx

若要详细了解 Office URI 方案，请参阅 Office URI 方案。

注意

必须在空白窗口或新选项卡中打开 URI。