VersionOverrides 1.1 в файле манифеста для почтовой надстройки

Этот элемент содержит сведения о функциях, которые не поддерживаются в базовом манифесте.

Примечание.

В этой статье предполагается, что вы знакомы с обзором элемента VersionOverrides, который содержит важные сведения об атрибутах и вариантах элемента.

Тип надстройки: почтовая

Допустимо только в следующих схемах VersionOverrides:

• Почта 1.1

Дополнительные сведения см. в статье "Переопределения версий в манифесте только для надстроек".

Связанные с этими наборами требований:

• Mailbox 1.5
• Некоторые дочерние элементы могут быть связаны с дополнительными наборами требований.

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

Следующая таблица относится только к элементам VersionOverrides> версии 1.1< и только к надстройкам почты.

Примечание.

В iOS поддерживается только <WebApplicationInfo> . Все остальные дочерние элементы <VersionOverrides> игнорируются.

Элемент	Обязательный	Описание
Описание	Нет	Описывает надстройку.
Requirements	Нет	Указывает минимальные наборы требований, которые должны поддерживаться для вступления в силу разметки в родительском <элементе VersionOverrides> . Это всегда должно быть более строгим, чем <элемент Requirements> в базовой части манифеста.
Hosts	Нет	Указывает набор приложений Office. Дочерний элемент Hosts переопределяет элемент Hosts в родительской части манифеста.
Ресурсы	Нет	Определяет коллекцию ресурсов (строк, URL-адресов и изображений), на которые ссылаются другие элементы манифеста.
EquivalentAddins	Нет	Указывает собственные надстройки (COM/XLL), эквивалентные веб-надстройке. Веб-надстройка не активируется, если установлена эквивалентная собственная надстройка.
<VersionOverrides>	Нет	В настоящее время невозможно использовать в VersionOverrides 1.1 для надстроек почты.
WebApplicationInfo	Нет	Указывает сведения о регистрации надстройки у издателей безопасных маркеров, таких как Azure Active Directory V2.0.
ExtendedPermissions	Нет	Указывает коллекцию расширенных разрешений.

Описание

Описывает надстройку. Это переопределяет <элемент Description> в любой родительской части манифеста. Текст описания содержится в дочернем элементе LongString, включенном в элемент Resources. Атрибут resid<элемента Description> может содержать не более 32 символов и должен совпадать со значением id атрибута дочернего элемента <элемента ShortString> , содержащегося в элементе Resources .

Тип надстройки: Область задач, почта

Допустимо только в следующих схемах VersionOverrides:

• Область задач 1.0
• Почта 1.0
• Почта 1.1

Дополнительные сведения см. в статье "Переопределения версий в манифесте только для надстроек".

Связанные с этими наборами требований:

• AddinCommands 1.1 , если родительским <параметром VersionOverrides> является тип области задач 1.0.
• Почтовый ящик 1.3 , если родительское <значение VersionOverrides> имеет тип Mail 1.0.
• Почтовый ящик 1.5 , если родительское <значение VersionOverrides> имеет тип Mail 1.1.

Пример

Ниже приведен простой пример. Более сложные примеры см. в манифестах для примеров надстроек в примерах кода надстройки Office.

Ниже приведен пример типичного <элемента VersionOverrides> , включая некоторые дочерние элементы, которые не являются обязательными, но обычно используются.

<OfficeApp ... xsi:type="MailApp">
...
  <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>
...
</OfficeApp>

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

В манифесте может быть реализовано несколько версий элемента VersionOverrides, которые поддерживают различные версии схемы VersionOverrides. Это можно сделать, чтобы поддерживать новые функции в новой схеме, по-прежнему поддерживая старые клиенты.

Чтобы реализовать несколько версий, элемент VersionOverrides для новой версии должен зависеть от элемента VersionOverrides для старой версии. Дочерний элемент VersionOverrides не наследует значения от родительского объекта.

Для реализации схем VersionOverrides версий 1.0 и 1.1 манифест будет выглядеть примерно так, как показано в следующем примере.

<OfficeApp ... xsi:type="MailApp">
...
  <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>