Runtime 元素
将外接程序配置为使用共享 JavaScript 运行时，以便所有组件都在同一运行时中运行。 Runtimes 元素的子元素。
加载项类型： 任务窗格，邮件
仅在以下 VersionOverrides 架构中有效：
- 任务窗格 1.0
- 邮件 1.1
有关详细信息，请参阅 仅外接程序清单中的版本替代。
与以下要求集关联：
- SharedRuntime 1.1 (仅在任务窗格外接程序中使用时 )
- 邮箱 1.10 及更高版本 (在实现 基于事件的 activation 的 Outlook 外接程序中使用时。)
- 邮箱预览 (在实现 集成垃圾邮件报告 (预览) 功能的 Outlook 加载项中使用时。)
重要
对于共享 JavaScript 运行时，此元素使功能区、任务窗格和其他受支持的组件能够使用相同的运行时。 但是，SharedRuntime 要求集仅在某些 Office 应用程序中可用。 有关详细信息，请参阅共享运行时要求集。
Outlook
- 例如，对于基于事件的激活，此元素允许加载项在撰写新项目时运行。 有关支持的客户端和其他信息，请参阅 为基于事件的激活配置 Outlook 外接程序。
- 对于集成垃圾邮件报告 (预览) ，此元素使外接程序能够处理未经请求的邮件。 若要详细了解如何在外接程序中实现集成的垃圾邮件报告功能，请参阅 实现集成的垃圾邮件报告加载项 (预览版) 。
请注意，基于事件的激活和集成的垃圾邮件报告功能必须使用相同的运行时。 Outlook 目前不支持多个运行时。
语法
<Runtimes>
<Runtime resid="ContosoAddin.Url" lifetime="long" />
</Runtimes>
包含于
子元素
| 元素 | 必需 | 说明 |
|---|---|---|
| Override | 否 |
Outlook：指定 Windows 版 Outlook 对 LaunchEvent 扩展点 和 ReportPhishingCommandSurface 扩展点所需的 JavaScript 文件的 URL 位置， (预览) 处理程序。
重要说明：目前，只能定义一个 <Override> 元素，并且该元素的类型必须为 javascript。 |
属性
| 属性 | 必需 | 说明 |
|---|---|---|
| resid | 是 | 指定外接程序的 HTML 页面的 URL 位置。
resid不能超过 32 个字符，并且必须与 元素中的 Resources 元素的属性Url匹配id。 |
| 辈子 | 否 | 的 lifetime 默认值为 short ，无需指定 。 Outlook 基于事件的激活和垃圾邮件报告加载项仅 short 使用 值。 如果要在 Excel 外接程序中使用共享运行时，请将值显式设置为 long。 |
lifetime 属性
可选。 表示允许加载项运行的时间长度。
可用值
short：违约。 仅用于 Outlook 基于事件的激活和垃圾邮件报告加载项。激活加载项后，它将按平台指定的最长时间运行。 目前，大约需要 5 分钟。 这是 Outlook 支持的唯一值。
long：仅在配置 共享 JavaScript 运行时时使用。 加载项可以在文档打开时启动并无限期运行。 例如，即使用户关闭任务窗格，任务窗格代码也会继续运行。 这是共享运行时支持的唯一值。