VersionOverrides-ElementVersionOverrides element

Das Stammelement, das Informationen für die Add-In-Befehle enthält, die durch das Add-In implementiert werden. VersionOverrides ist ein untergeordnetes Element des OfficeApp-Elements im Manifest. Dieses Element wird in Manifestschema v1. 1 und höher unterstützt, ist jedoch im VersionOverrides-Schema v1.0 oder v1.1 definiert.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.

AttributeAttributes

AttributAttribute ErforderlichRequired BeschreibungDescription
xmlnsxmlns JaYes Der Schemaspeicherort, der http://schemas.microsoft.com/office/mailappversionoverrides sein muss, wenn xsi:type VersionOverridesV1_0 ist, und http://schemas.microsoft.com/office/mailappversionoverrides/1.1, wenn xsi:type VersionOverridesV1_1 ist.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 JaYes Die Schemaversion. Zu diesem Zeitpunkt sind die einzigen zulässigen Werte VersionOverridesV1_0 und VersionOverridesV1_1.The schema version. At this time, the only valid values are VersionOverridesV1_0 and VersionOverridesV1_1.

Hinweis

Derzeit unterstützt nur Outlook 2016 oder höher das VersionOverrides v 1.1-Schema VersionOverridesV1_1 und den Typ.Currently only Outlook 2016 or later supports the VersionOverrides v1.1 schema and the VersionOverridesV1_1 type.

Untergeordnete ElementeChild elements

ElementElement ErforderlichRequired BeschreibungDescription
BeschreibungDescription NeinNo Beschreibt das Add-In. Dies überschreibt ggf. das Description-Element im übergeordneten Teil des Manifests. Der Text der Beschreibung ist in einem untergeordneten Element des LongString-Elements enthalten, das im RessourcenElement enthalten ist. Das resid-Attribut des Description-Elements wird auf den Wert des id-Attributs des String-Elements festgelegt, das den Text enthält.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.
EquivalentAddinsEquivalentAddins NeinNo Gibt die Abwärtskompatibilität mit einer entsprechenden COM-Add-in, XLL oder beides an.Specifies backwards compatibility with an equivalent COM add-in, XLL, or both.
AnforderungenRequirements NeinNo Gibt die Mindestanforderungen und die Version von Office.js an, die das Add-In erfordert. Dies überschreibt das Requirements-Element im übergeordneten Teil des Manifests.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 JaYes Gibt eine Auflistung von Office-Hosts an. Das untergeordnete Hosts-Element überschreibt das Hosts-Element im übergeordneten Teil des Manifests.Specifies a collection of Office hosts. The child Hosts element overrides the Hosts element in the parent portion of the manifest.
RessourcenResources JaYes Definiert eine Auflistung von Ressourcen (Zeichenfolgen, URLs und Bilder), auf die von anderen Elementen des Manifests verwiesen wird.Defines a collection of resources (strings, URLs, and images) that other manifest elements reference.
EquivalentAddinsEquivalentAddins NeinNo Gibt die systemeigenen Add-Ins (com/XLL) an, die dem-Add-in entsprechen.Specifies the native (COM/XLL) add-ins that are equivalent to the web add-in. Das WebAdd-in wird nicht aktiviert, wenn ein entsprechendes systemeigenes Add-in installiert ist.The web add-in is not activated if an equivalent native add-in is installed.
VersionOverridesVersionOverrides NeinNo Definiert Add-In-Befehle unter einer neueren Schemaversion. Einzelheiten finden Sie unter Implementieren mehrerer Versionen.Defines add-in commands under a newer schema version. See Implementing multiple versions for details.
WebApplicationInfoWebApplicationInfo NeinNo Gibt Details zur Registrierung des Add-Ins mit sicheren Token-herausgegebenen an, wie Azure Active Directory v 2.0.Specifies details about the add-in's registration with secure token issuers, such as Azure Active Directory V2.0.

VersionOverrides-BeispielVersionOverrides example

Es folgt ein Beispiel für ein typisches <VersionOverrides> Element, einschließlich einiger untergeordneter Elemente, die nicht erforderlich sind, aber in der Regel verwendet werden.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>

Implementieren mehrerer VersionenImplementing multiple versions

Ein Manifest kann mehrere Versionen des VersionOverrides-Elements implementieren, das unterschiedliche Versionen des VersionOverrides-Schemas unterstützt. Auf diese Weise können neue Features in einem neueren Schema unterstützt werden, während gleichzeitig ältere Clients unterstützt werden, die die neuen Features nicht unterstützen.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.

Um mehrere Versionen zu implementieren, muss das VersionOverrides-Element für die neuere Version ein untergeordnetes Element des VersionOverrides-Elements für die ältere Version sein.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. Das untergeordnete Element VersionOverrides erbt keine Werte vom übergeordneten Element.The child VersionOverrides element doesn't inherit any values from the parent.

Um sowohl das VersionOverrides-Schema v1.0 als auch v1.1 zu implementieren, würde das Manifest wie im folgenden Beispiel aussehen: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>