Элемент VersionOverridesVersionOverrides element

Корневой элемент, который содержит сведения о командах надстройки. Элемент манифеста VersionOverrides является дочерним для элемента OfficeApp. Этот элемент поддерживается в схеме манифестов версий 1.1 и выше, но определяется в схеме VersionOverrides версии 1.0 или 1.1.The root element that contains information for the add-in commands implemented by the add-in. VersionOverrides is a child element of the OfficeApp element in the manifest. This element is supported in manifest schema v1.1 and later but is defined in the VersionOverrides v1.0 or v1.1 schema.

АтрибутыAttributes

АтрибутAttribute ОбязательныйRequired ОписаниеDescription
xmlnsxmlns ДаYes Расположение схемы (http://schemas.microsoft.com/office/mailappversionoverrides, когда xsi:typeVersionOverridesV1_0, и http://schemas.microsoft.com/office/mailappversionoverrides/1.1, когда xsi:typeVersionOverridesV1_1).The schema location, which must be http://schemas.microsoft.com/office/mailappversionoverrides when xsi:type is VersionOverridesV1_0, and http://schemas.microsoft.com/office/mailappversionoverrides/1.1 when xsi:type is VersionOverridesV1_1.
xsi:typexsi:type ДаYes Версия схемы. В настоящее время допускаются только значения VersionOverridesV1_0 и VersionOverridesV1_1.The schema version. At this time, the only valid values are VersionOverridesV1_0 and VersionOverridesV1_1.

Примечание

В настоящее время только Outlook 2016 или более поздней версии поддерживает схему VersionOverrides VersionOverridesV1_1 1.1 и тип.Currently only Outlook 2016 or later supports the VersionOverrides v1.1 schema and the VersionOverridesV1_1 type.

Дочерние элементыChild elements

ЭлементElement ОбязательныйRequired ОписаниеDescription
ОписаниеDescription НЕТNo Описывает надстройку. Переопределяет элемент Description в любой родительской части манифеста. Текст описания содержится в дочернем элементе LongString, включенном в элемент Resources. Для атрибута resid элемента Description задано значение атрибута id элемента String, который содержит текст.Describes the add-in. This overrides the Description element in any parent portion of the manifest. The text of the description is contained in a child element of the LongString element contained in the Resources element. The resid attribute of the Description element is set to the value of the id attribute of the String element that contains the text.
екуивалентаддинсEquivalentAddins НетNo Задает обратную совместимость с эквивалентной надстройкой COM, XLL или и тем, и другими.Specifies backwards compatibility with an equivalent COM add-in, XLL, or both.
RequirementsRequirements НетNo Задает минимальные набор требований и версию библиотеки Office.js, необходимые надстройке. Переопределяет элемент Requirements в родительской части манифеста.Specifies the minimum requirement set and version of Office.js that the add-in requires. This overrides the Requirements element in the parent portion of the manifest.
HostsHosts ДаYes Задает набор узлов Office. Дочерний элемент Hosts переопределяет элемент Hosts в родительской части манифеста.Specifies a collection of Office hosts. The child Hosts element overrides the Hosts element in the parent portion of the manifest.
ResourcesResources ДаYes Определяет коллекцию ресурсов (строк, URL-адресов и изображений), на которые ссылаются другие элементы манифеста.Defines a collection of resources (strings, URLs, and images) that other manifest elements reference.
екуивалентаддинсEquivalentAddins НетNo Задает встроенные надстройки (COM/XLL), эквивалентные веб-надстройке.Specifies the native (COM/XLL) add-ins that are equivalent to the web add-in. Веб-надстройка не активируется, если установлена эквивалентная собственная встроенная надстройка.The web add-in is not activated if an equivalent native add-in is installed.
VersionOverridesVersionOverrides НетNo Определяет команды надстроек в новой версии схемы. Подробные сведения см. в разделе Реализация нескольких версий.Defines add-in commands under a newer schema version. See Implementing multiple versions for details.
WebApplicationInfoWebApplicationInfo НетNo Задает сведения о регистрации надстройки с помощью надежных поставщиков маркеров, таких как Azure Active Directory 2.0.Specifies details about the add-in's registration with secure token issuers, such as Azure Active Directory V2.0.

Пример VersionOverridesVersionOverrides example

Ниже приведен пример типичного <VersionOverrides> элемента, в том числе некоторые необязательные дочерние элементы, которые обычно используются.The following is an example of a typical <VersionOverrides> element, including some child elements that are not required but are typically used.

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

Реализация нескольких версийImplementing multiple versions

В манифесте может быть реализовано несколько версий элемента VersionOverrides, которые поддерживают различные версии схемы VersionOverrides. Это можно сделать, чтобы поддерживать новые функции в новой схеме, по-прежнему поддерживая старые клиенты.A manifest can implement multiple versions of the VersionOverrides element which support different versions of the VersionOverrides schema. This can be done to optionally support new features in a newer schema while still supporting older clients that do not support the new features.

Чтобы реализовать несколько версий, элемент VersionOverrides для новой версии должен зависеть от элемента VersionOverrides для старой версии.In order to implement multiple versions, the VersionOverrides element for the newer version must be a child of the VersionOverrides element for the older version. Дочерний элемент VersionOverrides не наследует значения от родительского объекта.The child VersionOverrides element doesn't inherit any values from the parent.

Чтобы реализовать схему VersionOverrides версий 1.0 и 1.1, манифест должен выглядеть следующим образом:To implement both the VersionOverrides v1.0 and v1.1 schema, the manifest would look similar to the following example:

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

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