Runtime 元素

将外接程序配置为使用共享 JavaScript 运行时，以便所有组件都在同一运行时中运行。 Runtimes 元素的子元素。

加载项类型： 任务窗格，邮件

仅在以下 VersionOverrides 架构中有效：

有关详细信息，请参阅清单中的版本替代。

与以下要求集关联：

重要

对于共享 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`。

可选。表示允许加载项运行的时间长度。

short：默认。仅用于 Outlook 基于事件的激活和垃圾邮件报告加载项。激活加载项后，它将按平台指定的最长时间运行。目前，大约需要 5 分钟。这是 Outlook 支持的唯一值。

long：仅在配置共享 JavaScript 运行时时使用。加载项可以在文档打开时启动并无限期运行。例如，即使用户关闭任务窗格，任务窗格代码也会继续运行。这是共享运行时支持的唯一值。