AppDomain 元素
除了 在 SourceLocation 元素中指定的域之外,还指定 Office 应信任的其他域。 指定域具有以下效果:
- 它使域中的页面、路由或其他资源可以直接在桌面 Office 平台上的外接程序的根任务窗格中打开。 (在 AppDomain> 中<指定域对于 Web 上的 Office 或打开 IFrame 中的资源而言,也不需要在使用对话框 API 打开的对话框中打开资源。)
- 它使域中的页面能够从外接程序中的 IFrame 进行 Office.js API 调用。
加载项类型:内容、任务窗格和邮件
语法
<AppDomain>string</AppDomain>
重要
-
AppDomain> 元素的值<必须包含协议 (例如,
<AppDomain>https://myappdomain.com</AppDomain>
) ,并且协议必须为http
或https
。 - 如果域有显式端口,请将其包含在 (例如
<AppDomain>https://myappdomain.com:9999</AppDomain>
) 。 - 如果需要信任子域,请 (包括子域,
<AppDomain>https://mysubdomain.myappdomain.com</AppDomain>
例如) 。 子域mysubdomain.mydomain.com
和mydomain.com
是不同的域。 如果两者都需要受信任,则两者都需要位于单独的 <AppDomain> 元素中。 - 列出与 SourceLocation 元素 中指定的域相同的域不起作用,并且可能会产生误导性。 特别是,在 上进行
localhost
开发时,无需为localhost
创建 <AppDomain> 元素。 - 不要包含域后 URL 的任何段。 例如,不要包含页面的完整 URL。
- 不要在值上添加右斜杠“/”。
-
AppDomain> 值中<不允许使用通配符(例如
*
),但是,对于仅在 Windows 上的 Office 中运行的加载项,有一种方法可以使用通配符指定其他受信任的域。 请参阅 通配符受信任域。
包含于
备注
有关详细信息,请参阅 具有仅加载项清单的 Office 外接程序。