Freigeben über

Host-Element

  • Artikel

Gibt einen einzelnen Office-Anwendungstyp an, in dem das Add-In aktiviert werden sollte.

Wichtig

Die <Syntax des Host-Elements> hängt davon ab, ob das Element im Basismanifest oder im VersionOverrides-Knoten definiert ist. Die Funktionalität ist jedoch dieselbe.

Grundlegendes Manifest

Wenn dies im grundlegenden Manifest (unter OfficeApp) definiert ist, wird der Hosttyp vom Name-Attribut bestimmt.

Attribute

Attribut Typ Erforderlich Beschreibung
Name string Ja Der Name des Typs der Office-Clientanwendung.

Name

Gibt den Hosttyp an, auf den von diesem Add-In abgezielt wird. Bei dem Wert muss es sich um Folgendes handeln:

  • Document (Word)
  • Mailbox (Outlook)
  • Notebook (OneNote)
  • Presentation (PowerPoint)
  • Project (Project)
  • Workbook (Excel)
  • Database (Zugriff (veraltet))

Beispiel

<Hosts>
    <Host Name="Mailbox">
    </Host>
</Hosts>

VersionOverrides-Knoten

Wenn dies im VersionOverrides definiert ist, wird der Hosttyp vom xsi:type-Attribut bestimmt.

Dieses Element überschreibt das <Hosts-Element> im Basismanifest.

Add-In-Typ: Aufgabenbereich, E-Mail

Nur in den folgenden VersionOverrides-Schemas gültig:

  • Aufgabenbereich 1.0
  • Mail 1.0
  • Mail 1.1

Weitere Informationen finden Sie unter Versionsüberschreibungen im reinen Add-In-Manifest.

Attribute

Attribut Erforderlich Beschreibung
xsi:type Ja Gibt die Office-Anwendung an, in der diese Einstellungen gelten.

Untergeordnete Elemente

Element Erforderlich Beschreibung
DesktopFormFactor Ja Definiert die Einstellungen für den Desktopformfaktor an.
MobileFormFactor Nein Definiert die Einstellungen für den mobilen Formfaktor. Anmerkung: Dieses Element wird nur in Outlook unter Android und iOS unterstützt.
AllFormFactors Nein Definiert die Einstellungen für alle Formfaktoren. Nur von benutzerdefinierte Funktionen in Excel verwendet.
Runtimes Nein Gibt die Laufzeiten Ihres Add-Ins an.

xsi:type

Steuert, welche Office-Anwendung (Word, Excel, PowerPoint, Outlook, OneNote) auf die enthaltenen Einstellungen angewendet wird. Bei dem Wert muss es sich um Folgendes handeln:

  • Document (Word)
  • MailHost (Outlook)
  • Notebook (OneNote)
  • Presentation (PowerPoint)
  • Workbook (Excel)

Host-Beispiel

<Hosts>
    <Host xsi:type="MailHost">
        <!-- Host Settings -->
    </Host>
</Hosts>