Host-Element

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)
• Database (Access)
• Mailbox (Outlook)
• Notebook (OneNote)
• Presentation (PowerPoint)
• Project (Project)
• Workbook (Excel)

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 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. Hinweis: Dieses Element wird nur in Outlook unter iOS und Android unterstützt.
AllFormFactors	Nein	Definiert die Einstellungen für alle Formfaktoren. Nur von benutzerdefinierte Funktionen in Excel verwendet.
Laufzeiten	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>