Runtime 元素

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

加载项类型: 任务窗格,邮件

仅在以下 VersionOverrides 架构中有效

  • 任务窗格 1.0
  • 邮件 1.1

有关详细信息,请参阅 仅外接程序清单中的版本替代

与以下要求集关联

重要

对于共享 JavaScript 运行时,此元素使功能区、任务窗格和其他受支持的组件能够使用相同的运行时。 但是,SharedRuntime 要求集仅在某些 Office 应用程序中可用。 有关详细信息,请参阅共享运行时要求集

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 运行时时使用。 加载项可以在文档打开时启动并无限期运行。 例如,即使用户关闭任务窗格,任务窗格代码也会继续运行。 这是共享运行时支持的唯一值。

另请参阅