Anwendungsmanifeste für Office-Projektmappen

Artikel
02/26/2013

Bei einem Anwendungsmanifest handelt es sich um eine XML-Datei, die die Assemblys beschreibt, die in eine Microsoft Office-Projektmappe geladen werden.Für die Microsoft Office-Entwicklungstools in Visual Studio wird das in der Referenz ClickOnce-Anwendungsmanifest definierte ClickOnce-Anwendungsmanifestschema verwendet.

In Anwendungsmanifesten für Office-Projektmappen werden die folgenden ClickOnce-Elemente und -Attribute verwendet.

Element	Beschreibung	Attribute
<assembly>-Element (ClickOnce-Anwendung)	Erforderlich.Oberstes Element.	manifestVersion
<assemblyIdentity>-Element (ClickOnce-Anwendung)	Erforderlich.Identifiziert die primäre Assembly der ClickOnce-Anwendung.	name version publicKeyToken processorArchitecture language
<trustInfo>-Element (ClickOnce-Anwendung)	Identifiziert die Sicherheitsanforderungen der Anwendung.	None
<entryPoint>-Element (ClickOnce-Anwendung)	Erforderlich.Identifiziert den Anwendungscodeeinstiegspunkt für die Ausführung.	name dependencyName customHostSpecified
<dependency>-Element (ClickOnce-Anwendung)	Erforderlich.Identifiziert die zum Ausführen der Anwendung erforderlichen Abhängigkeiten.Identifiziert optional Assemblys, die vorinstalliert werden müssen.	None
<file>-Element (ClickOnce-Anwendung)	Erforderlich.Identifiziert jede Nicht-Assemblydatei, die von der Anwendung verwendet wird.Kann der Datei zugeordnete COM-Isolationsdaten (Component Object Model) umfassen.	name size

Anwendungsmanifeste für Office-Projektmappen weisen im co.v1-Namespace das folgende Element auf.

<entryPoint>
    <co.v1:customHostSpecified />
</entryPoint>

Diese Anwendungsmanifeste weisen im vstav3-Namespace auch die folgenden Elemente und Attribute 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 speziell als Office-Projektmappe.	None
<addin>-Element (Office-Entwicklung in Visual Studio)	Erforderlich.Speichert Einstiegspunkte in einem einzelnen Namespace.	None
<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 für die Ausführung einer Office-Projektmappe.	None
<entryPoint>-Element (Office-Entwicklung in Visual Studio)	Erforderlich.Bezeichnet die Assembly, die in einer Office-Projektmappe ausgeführt werden soll.	class contract
<update>-Element (Office-Entwicklung in Visual Studio)	Erforderlich.Konfiguriert Aktualisierungen für die Projektmappe.	enabled expiration
<postActions>-Element (Office-Entwicklung in Visual Studio)	Optional.Gruppiert alle Aktionen nach der Bereitstellung, die nach der Installation der Office-Projektmappen ausgeführt werden.	None
<postAction>-Element (Office-Entwicklung in Visual Studio)	Optional.Bezeichnet eine Aktion nach der Bereitstellung.	None
<postActionData>-Element (Office-Entwicklung in Visual Studio)	Optional.Konfiguriert Daten für eine Aktion nach der Bereitstellung.	None
<application>-Element (Office-Entwicklung in Visual Studio)	Erforderlich.Umschließt die anwendungsspezifischen Informationen in einem Einzelknoten.	None
<customizations>-Element (Office-Entwicklung in Visual Studio)	Erforderlich.Speichert alle anwendungshostspezifischen Informationen in einem gesonderten Namespace.	None
<customization>-Element (Office-Entwicklung in Visual Studio)	Erforderlich.Speichert anwendungshostspezifische Informationen in einem gesonderten 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 Add-Ins, das in der Liste der installierten Add-Ins angezeigt wird.	None
<description>-Element (Office-Entwicklung in Visual Studio)	Nur für Add-Ins auf Anwendungsebene erforderlich.Speichert die Beschreibung, die in der Liste der installierten Programme angezeigt wird.	None
<formRegions>-Element (Office-Entwicklung in Visual Studio)	Erforderlich nur für diese Outlook-Add-Ins enthalten formularbereiche.	None
<formRegion>-Element (Office-Entwicklung in Visual Studio)	Erforderlich nur für diese Outlook-Add-Ins enthalten formularbereiche.	Name
<vstoRuntime>-Element (Office-Entwicklung in Visual Studio)	Erforderlich.Beschreibt eine bestimmte, von der Office-Projektmappe unterstützte Version der Visual Studio Tools for Office-Laufzeit.	release version supportUrl

Hinweise

Anwendungs- und Bereitstellungsmanifeste in Office-Lösungen können manuell bearbeitet werden.Anschließend müssen Sie die Anwendungs- und Bereitstellungsmanifeste müssen mit dem Tool zum Generieren und Bearbeiten von Manifesten (mage.exe und mageui.exe) erneut signieren.Weitere Informationen finden Sie unter Gewusst wie: Erneutes Signieren von Anwendungs- und Bereitstellungsmanifesten.

Dateispeicherort

Ein Anwendungsmanifest ist nur für eine einzelne Version einer Projektmappe bestimmt.Aus diesem Grund müssen Anwendungsmanifeste getrennt von Bereitstellungsmanifesten gespeichert werden.Visual Studio platziert die versionsspezifischen Dateien in einem Unterverzeichnis, das entsprechend der zugeordneten Version im Unterverzeichnis Anwendungsdateien im Veröffentlichungsordner benannt ist.

Dateinamensyntax

Der Name einer Anwendungsmanifestdatei muss mit dem im assemblyIdentity-Element identifizierten vollständigen Namen und der entsprechenden Erweiterung identisch sein und die Erweiterung .manifest aufweisen.Beispielsweise verwendet ein Anwendungsmanifest, das auf die OutlookAddIn1.dll-Anpassung verweist, die folgende Dateinamensyntax.

OutlookAddIn1.dll.manifest

Siehe auch

Referenz

Bereitstellungsmanifeste für Office-Projektmappen

ClickOnce-Anwendungsmanifest

Freigeben über