任务窗格外接程序的清单文件中的 VersionOverrides 1.0 元素

此元素包含基本清单中不支持的功能的信息。

注意

本文假定你熟悉 VersionOverrides 元素的概述,其中包含有关元素的属性和变体的重要信息。

外接程序类型: 任务窗格

仅在以下 VersionOverrides 架构中有效

  • Taskpane 1.0

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

与以下要求集关联

  • Excel、PowerPoint 和 Word) 需要 AddinCommands 1.1 (
  • 某些子元素可能与其他要求集相关联。

子元素

下表仅适用于 VersionOverrides> 元素的 1.0 版<,仅适用于任务窗格加载项。

注意

在 iOS 中,仅 <支持 WebApplicationInfo>将忽略 VersionOverrides> 的<所有其他子元素。

元素 必需 说明
说明 描述外接程序。
Requirements 指定必须支持的最低要求集,以便父 <VersionOverrides> 中的标记生效。 这应始终比清单基部分中的 <Requirements> 元素严格。
Hosts 指定 Office 应用程序的集合。 子 Hosts 元素替代清单父部分中的 Hosts 元素。
资源 定义其他清单元素引用的资源集合(字符串、URL 和图像)。
EquivalentAddins 指定与 Web 加载项等效的本机 (COM/XLL) 加载项。 如果安装了等效的本机加载项,则不会激活 Web 加载项。
<VersionOverrides> 目前无法在 VersionOverrides 1.0 中用于 taskpane 加载项。
WebApplicationInfo 指定有关外接程序向安全令牌颁发者(例如 Azure Active Directory V2.0)注册的详细信息。

说明

描述外接程序。 这将覆盖清单的任何父部分中的 Description> 元素。< 说明文本包含在 Rescources 元素中的 LongString 元素的子元素中。 residDescription> 元素的属性<不能超过 32 个字符,并且必须与 Resources 元素中包含的 ShortString> 元素的<子元素的 属性的值id匹配。

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

仅在以下 VersionOverrides 架构中有效

  • 任务窗格 1.0
  • 邮件 1.0
  • 邮件 1.1

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

与以下要求集关联

  • 当父 <VersionOverrides> 类型为 Taskpane 1.0 时,AddinCommands 1.1。
  • 当父 <VersionOverrides> 类型为 Mail 1.0 时邮箱 1.3。
  • 当父 <VersionOverrides> 类型为 Mail 1.1 时邮箱 1.5。

示例

下面展示了一个非常简单的示例。 有关更复杂的示例,请参阅 Office 外接程序代码示例中示例加载项的清单。

<OfficeApp ... xsi:type="Taskpane">
...
  <VersionOverrides xmlns="http://schemas.microsoft.com/office/taskpaneappversionoverrides" xsi:type="VersionOverridesV1_0">
    <Description resid="residDescription" />
    <Requirements>
      <!-- add information on requirements -->
    </Requirements>
    <Hosts>
      <Host xsi:type="Workbook">
        <!-- add information on form factors -->
      </Host>
    </Hosts>
    <Resources>
      <!-- add information on resources -->
    </Resources>
  </VersionOverrides>
...
</OfficeApp>