Anwendungsmanifeste für Office-Lösungen
Ein Anwendungsmanifest ist eine XML-Datei, die die Assemblys beschreibt, die in einer Microsoft Office-Projektmappe geladen werden. Die Microsoft Office-Entwicklungstools in Visual Studio verwenden das ClickOnce-Anwendungsmanifestschema, das in der ClickOnce-Anwendungsmanifestreferenz definiert ist.
Anwendungsmanifeste für Office-Lösungen verwenden die folgenden ClickOnce-Elemente und -Attribute.
| Element | Beschreibung | Attribute |
|---|---|---|
| <assembly-Element> (ClickOnce-Anwendung) | Erforderlich. Ein Element der obersten Ebene. | manifestVersion |
| <assemblyIdentity-Element> (ClickOnce-Anwendung) | Erforderlich. Identifiziert die primäre Assembly der ClickOnce-Anwendung. | name Version publicKeyToken processorArchitecture language |
| <trustInfo-Element> (ClickOnce-Anwendung) | Gibt die Sicherheitsanforderungen der Anwendung an. | Keine |
| <entryPoint-Element> (ClickOnce-Anwendung) | Erforderlich. Gibt den Einstiegspunkt des Anwendungscodes für die Ausführung an. | name Abhängigkeitsname Customhostspecified |
| <Abhängigkeitselement> (ClickOnce-Anwendung) | Erforderlich. Gibt jede Abhängigkeit an, die für die Ausführung der Anwendung erforderlich ist. Gibt optional Assemblys an, die vorinstalliert werden müssen. | Keine |
| <file-Element> (ClickOnce-Anwendung) | Erforderlich. Gibt jede Nicht-Assemblydatei an, die von der Anwendung verwendet wird. Kann COM-Isolationsdaten (Component Object Model) enthalten, die der Datei zugeordnet sind. | name size |
Anwendungsmanifeste für Office-Projektmappen verwenden das folgenden Element im co.v1 -Elemente.
<entryPoint>
<co.v1:customHostSpecified />
</entryPoint>
Diese Anwendungsmanifeste weisen auch die folgenden Elemente und Attribute im vstav3 -Namespace auf.
<addIn>
<entryPointsCollection>
<entryPoints>
<entryPoint>
</entryPoint>
</entryPoints>
</entryPointsCollection>
<update></update>
<postActions>
<postAction>
<postActionData>
</postActionData>
<postAction>
</postActions>
<application>
<customizations>
<customization>
</customization>
</customizations>
</application
</addIn>
| Element | Beschreibung | Attribute |
|---|---|---|
| <customHostSpecified-Element> (Office-Entwicklung in Visual Studio) | Erforderlich. Markiert das Manifest ausdrücklich als Office-Projektmappe. | Keine |
| <addin-Element> (Office-Entwicklung in Visual Studio) | Erforderlich. Speichert Einstiegspunkte in einem einzelnen Namespace. | Keine |
| <entryPointsCollection-Element> (Office-Entwicklung in Visual Studio) | Erforderlich. Gruppiert alle Assemblys für eine oder mehrere Office-Projektmappen. | id |
| <entryPoints-Element> (Office-Entwicklung in Visual Studio) | Erforderlich. Gruppiert alle Assemblys, die in einer Office-Projektmappe ausgeführt werden. | Keine |
| <entryPoint-Element> (Office-Entwicklung in Visual Studio) | Erforderlich. Gibt die Assemblys an, die in einer Office-Projektmappe ausgeführt werden. | class Vertrag |
| <Update-Element> (Office-Entwicklung in Visual Studio) | Erforderlich. Konfiguriert Updates für die Projektmappe. | enabled expiration |
| <postActions-Element> (Office-Entwicklung in Visual Studio) | Optional. Gruppiert alle Aktionen nach der Bereitstellung, die nach der Installation von Office-Projektmappen ausgeführt werden. | Keine |
| <postAction-Element> (Office-Entwicklung in Visual Studio) | Optional. Gibt eine Aktion nach der Bereitstellung an. | Keine |
| <postActionData-Element> (Office-Entwicklung in Visual Studio) | Optional. Konfiguriert Daten für eine Aktion nach der Bereitstellung. | Keine |
| <application-Element> (Office-Entwicklung in Visual Studio) | Erforderlich. Umschließt die anwendungsspezifischen Informationen in einem einzelnen Knoten. | Keine |
| <customizations-Element> (Office-Entwicklung in Visual Studio) | Erforderlich. Speichert alle anwendungshostspezifischen Informationen in einem separaten Namespace. | Keine |
| <customization-Element> (Office-Entwicklung in Visual Studio) | Erforderlich. Speichert anwendungshostspezifische Informationen in einem separaten Namespace. | xmlns |
| <document-Element> (Office-Entwicklung in Visual Studio) | Nur für Projektmappen auf Dokumentebene erforderlich. Speichert anpassungsspezifische Informationen. | Solutionid |
| <appAddin-Element> (Office-Entwicklung in Visual Studio) | Nur für Projektmappen auf Anwendungsebene erforderlich. Speichert anpassungsspezifische Informationen. | application Loadbehavior keyName |
| <friendlyName-Element> (Office-Entwicklung in Visual Studio) | Optional. Speichert den Namen des VSTO-Add-Ins, das in der Liste der installierten VSTO-Add-Ins angezeigt wird. | Keine |
| <description-Element> (Office-Entwicklung in Visual Studio) | Nur für VSTO-Add-Ins erforderlich. Speichert die Beschreibung, die in der Liste der installierten Programme angezeigt wird. | Keine |
| <formRegions-Element> (Office-Entwicklung in Visual Studio) | Nur für Outlook VSTO-Add-Ins erforderlich, die Formularbereiche enthalten. | Keine |
| <formRegion-Element> (Office-Entwicklung in Visual Studio) | Nur für Outlook VSTO-Add-Ins erforderlich, die Formularbereiche enthalten. | Name |
| <vstoRuntime-Element> (Office-Entwicklung in Visual Studio) | Erforderlich. Beschreibt eine bestimmte Version der Visual Studio Tools for Office-Laufzeit, die von der Office-Projektmappe unterstützt wird. | release Version Supporturl |
Hinweise
Anwendungs- und Bereitstellungsmanifeste in Office-Projektmappen können manuell bearbeitet werden. Anschließend müssen Sie die Anwendungs- und Bereitstellungsmanifeste erneut signieren, indem Sie das Tool zur Manifestgenerierung und -bearbeitung (mage.exe und mageui.exe) verwenden. Weitere Informationen finden Sie unter How to: Re-sign Application and Deployment Manifests (Vorgehensweise: Erneutes Signieren von Anwendungs- und Bereitstellungsmanifesten).
Datei-Lagerplatz
Ein Anwendungsmanifest ist für eine einzelne Version einer Projektmappe spezifisch. Aus diesem Grund müssen die Anwendungsmanifeste getrennt von Bereitstellungsmanifesten gespeichert werden. Visual Studio platziert die versionsspezifischen Dateien in einem Unterverzeichnis, das nach der zugeordneten Version im Unterverzeichnis "Anwendungsdateien " im Veröffentlichungsordner benannt ist.
Dateinamenssyntax
Der Name einer Anwendungsmanifestdatei sollte der vollständige Name und die Erweiterung der Anwendung sein, wie im assemblyIdentity-Element angegeben, gefolgt von der Erweiterung .manifest. Ein Anwendungsmanifest, das sich auf die Anpassung von OutlookAddIn1.dll bezieht, würde beispielsweise die folgende Dateinamensyntax verwenden.
OutlookAddIn1.dll.manifest