AppDomain 元素

指定除在 SourceLocation 元素中指定的域之外,Office 还应信任的其他域。 指定域具有以下效果:

  • 它允许在桌面 Office 平台上加载项的根任务窗格中直接打开域中的页面、路由或其他资源。 (Office web 版或在 IFrame 中打开资源不需要在 AppDomain> 中<指定域,也不需要在使用对话框 API 打开的对话框中打开资源。)
  • 它使域中的页面能够从加载项内的 IFrames 进行 Office.js API 调用。

加载项类型:内容、任务窗格和邮件

语法

<AppDomain>string</AppDomain>

重要

  1. AppDomain> 元素的<值必须包含协议 (例如 <AppDomain>https://myappdomain.com</AppDomain>) ,并且协议必须是 或 https。http
  2. 如果域有显式端口,请将其包含在 (,例如<AppDomain>https://myappdomain.com:9999</AppDomain>) 。
  3. 如果需要信任子域,请将其包含在 (例如<AppDomain>https://mysubdomain.myappdomain.com</AppDomain>) 。 子域 mysubdomain.mydomain.com 和 mydomain.com 是不同的域。 如果两者都需要信任,则两者都需要位于单独的 <AppDomain> 元素中。
  4. 列出与 SourceLocation 元素 中指定的域相同的域不起作用,并且可能误导。 在 上 localhost开发时,通常不需要为其创建 <AppDomain> 元素。 但是,如果你要在 Outlook 网页版或新 Outlook on Windows 上运行的加载项中实现对话框 API,则必须<为创建 AppDomain> 元素。localhost
  5. 不要包含超出域的任何 URL 段。 例如,不要包含页面的完整 URL。
  6. 不要在值上添加左斜线“/”。
  7. AppDomain> 值中<不允许使用通配符(如 *);但是,对于仅在 Windows 上的 Office 中运行的加载项,有一种方法可以使用通配符指定其他受信任的域。 请参阅 通配符受信任的域。

包含于

备注

有关详细信息,请参阅具有 仅加载项清单的 Office 加载项。