Anwendungsmanifeste für Office-Projektmappen
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 |
|---|---|---|
Erforderlich.Oberstes Element. |
manifestVersion |
|
Erforderlich.Identifiziert die primäre Assembly der ClickOnce-Anwendung. |
name version publicKeyToken processorArchitecture language |
|
Identifiziert die Sicherheitsanforderungen der Anwendung. |
None |
|
Erforderlich.Identifiziert den Anwendungscodeeinstiegspunkt für die Ausführung. |
name dependencyName customHostSpecified |
|
Erforderlich.Identifiziert die zum Ausführen der Anwendung erforderlichen Abhängigkeiten.Identifiziert optional Assemblys, die vorinstalliert werden müssen. |
None |
|
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 |
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 |
Erforderlich.Gruppiert alle Assemblys für die Ausführung einer Office-Projektmappe. |
None |
|
Erforderlich.Bezeichnet die Assembly, die in einer Office-Projektmappe ausgeführt werden soll. |
class contract |
|
Erforderlich.Konfiguriert Aktualisierungen für die Projektmappe. |
enabled expiration |
|
Optional.Gruppiert alle Aktionen nach der Bereitstellung, die nach der Installation der Office-Projektmappen ausgeführt werden. |
None |
|
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 |
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 |
Nur für Projektmappen auf Dokumentebene erforderlich.Speichert anpassungsspezifische Informationen. |
solutionId |
|
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 |
Nur für Add-Ins auf Anwendungsebene erforderlich.Speichert die Beschreibung, die in der Liste der installierten Programme angezeigt wird. |
None |
|
Erforderlich nur für diese Outlook-Add-Ins enthalten formularbereiche. |
None |
|
Erforderlich nur für diese Outlook-Add-Ins enthalten formularbereiche. |
Name |
|
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