Share via

AppDomain 元素

  • 项目

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

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

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

语法

<AppDomain>string</AppDomain>

重要

  1. AppDomain> 元素的值<必须包含协议 (例如， <AppDomain>https://myappdomain.com</AppDomain>) ，并且协议必须为 http 或 https。
  2. 如果域有显式端口，请将其包含在 (例如<AppDomain>https://myappdomain.com:9999</AppDomain>) 。
  3. 如果需要信任子域，请 (包括子域，<AppDomain>https://mysubdomain.myappdomain.com</AppDomain> 例如) 。 子域 mysubdomain.mydomain.com 和 mydomain.com 是不同的域。 如果两者都需要受信任，则两者都需要位于单独的 <AppDomain> 元素中。
  4. 列出与 SourceLocation 元素 中指定的域相同的域不起作用，并且可能会产生误导性。 特别是，在 上进行localhost开发时，无需为 localhost创建 <AppDomain> 元素。
  5. 不要包含域后 URL 的任何段。 例如，不要包含页面的完整 URL。
  6. 不要在值上添加右斜杠“/”。
  7. AppDomain> 值中<不允许使用通配符（例如 *），但是，对于仅在 Windows 上的 Office 中运行的加载项，有一种方法可以使用通配符指定其他受信任的域。 请参阅 通配符受信任域。

包含于

备注

有关详细信息，请参阅 Office 外接程序 XML 清单。