Anwendungsmanifeste für Office-Projektmappen (2007 System)
Aktualisiert: November 2007
Hinweis |
Betrifft |
|---|---|
Die Informationen in diesem Thema gelten nur für die angegebenen Visual Studio Tools for Office-Projekte und Versionen von Microsoft Office. Weitere Informationen hierzu finden Sie unter Verfügbare Features nach Anwendung und Projekttyp. |
Projekttyp
Microsoft Office-Version
|
Bei einem Anwendungsmanifest in einer Visual Studio Tools for Office-Projektmappe handelt es sich um eine XML-Datei, die Assemblys beschreibt, die in eine Microsoft Office-Projektmappe geladen werden.
Visual Studio Tools for Office verwendet das in der Referenz zu ClickOnce-Anwendungsmanifest definierte ClickOnce-Anwendungsmanifestschema.
Visual Studio Tools for Office-Anwendungsmanifeste verwenden die folgenden ClickOnce-Elemente und Attribute.
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. |
Keine |
|
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. |
Keine |
|
Erforderlich. Identifiziert jede Nicht-Assemblydatei, die von der Anwendung verwendet wird. Kann der Datei zugeordnete COM-Isolationsdaten (Component Object Model) umfassen. |
name size |
Visual Studio Tools for Office-Anwendungsmanifeste verfügen im co.v1-Namespace über das folgende Element.
<entryPoint>
<co.v1:customHostSpecified />
</entryPoint>
Visual Studio Tools for Office-Anwendungsmanifeste verfügen auch über die folgenden Elemente und Attribute im vstav2-Namespace.
<addIn>
<entryPoints>
<entryPoint>
</entryPoint>
</entryPoints>
<update></update>
<application>
<customization>
</customization>
</application
</addIn>
Element |
Beschreibung |
Attribute |
|---|---|---|
Erforderlich. Markiert das Manifest speziell als Office-Projektmappe. |
Keine |
|
Erforderlich. Speichert Einstiegspunkte in einem einzelnen Namespace. |
Keine |
|
Erforderlich. Gruppiert alle auszuführenden Assemblys. |
Keine |
|
Erforderlich. Identifiziert die auszuführende Assembly. |
class contract |
|
Erforderlich. Konfiguriert Aktualisierungen für die Projektmappe. |
enabled expiration |
|
Erforderlich. Umschließt die anwendungsspezifischen Informationen in einem Einzelknoten. |
Keine |
|
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 |
|
Optional. Speichert den Namen des Add-Ins, das in der Liste der installierten Add-Ins angezeigt wird. |
Keine |
|
Nur für Add-Ins auf Anwendungsebene erforderlich. Speichert die Beschreibung, die in der Liste der installierten Programme angezeigt wird. |
Keine |
|
Nur für Outlook 2007-Add-Ins erforderlich, die Formularbereiche beinhalten. |
Keine |
|
Nur für Outlook 2007-Add-Ins erforderlich, die Formularbereiche beinhalten. |
name |
Hinweise
Anwendungs- und Bereitstellungsmanifeste in Visual Studio Tools for Office-Projektmappen können manuell bearbeitet werden. Anwendungs- und Bereitstellungsmanifeste müssen mit dem Tool zum Generieren und Bearbeiten von Manifesten (mage.exe und mageui.exe) nach dem Bearbeiten der Manifeste erneut signiert werden. Signieren Sie zuerst das Anwendungsmanifest und anschließend das Bereitstellungsmanifest. Weitere Informationen finden Sie unter Tool zum Generieren und Bearbeiten von Manifesten (Mage.exe) und unter Tool zum Generieren und Bearbeiten von Manifesten, grafischer Client (MageUI.exe).
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
ExcelWorkbook1.dll.manifest
Beispiel für die Anpassung auf Dokumentebene
Beschreibung
Im folgenden Codebeispiel werden die für eine Visual Studio Tools for Office-Projektmappe spezifischen Abschnitte eines Anwendungsmanifests gezeigt. Hierbei handelt es sich um eine Microsoft Office Excel 2007-Anpassung auf Dokumentebene.
Code
<entryPoint>
<co.v1:customHostSpecified />
</entryPoint>
[...]
<vstav2:addIn xmlns:vstav2="urn:schemas-microsoft-com:vsta.v2">
<vstav2:entryPoints>
<vstav2:entryPoint class="ExcelWorkbook1.ThisWorkbook">
<assemblyIdentity
name="ExcelWorkbook1"
version="1.0.0.0"
language="neutral"
processorArchitecture="msil" />
</vstav2:entryPoint>
<vstav2:entryPoint class="ExcelWorkbook1.Sheet1">
<assemblyIdentity
name="ExcelWorkbook1"
version="1.0.0.0"
language="neutral"
processorArchitecture="msil" />
</vstav2:entryPoint>
<vstav2:entryPoint class="ExcelWorkbook1.Sheet2">
<assemblyIdentity
name="ExcelWorkbook1"
version="1.0.0.0"
language="neutral"
processorArchitecture="msil" />
</vstav2:entryPoint>
<vstav2:entryPoint class="ExcelWorkbook1.Sheet3">
<assemblyIdentity
name="ExcelWorkbook1"
version="1.0.0.0"
language="neutral"
processorArchitecture="msil" />
</vstav2:entryPoint>
</vstav2:entryPoints>
<vstav2:update enabled="true">
<vstav2:expiration maximumAge="7" unit="days" />
</vstav2:update>
<vstav2:application>
<vstov3:customization
xmlns:vstov3="urn:schemas-microsoft-com:vsto.v3">
<vstov3:document
solutionId="989..." />
</vstov3:customization>
</vstav2:application>
</vstav2:addIn>
Beispiel für Add-Ins auf Anwendungsebene
Beschreibung
Im folgenden Codebeispiel werden die für eine Visual Studio Tools for Office-Projektmappe spezifischen Abschnitte eines Anwendungsmanifests gezeigt. Hierbei handelt es sich um ein Microsoft Office Outlook 2007-Add-In auf Anwendungsebene, das einen Formularbereich beinhaltet.
Code
<entryPoint>
<co.v1:customHostSpecified />
</entryPoint>
[...]
<vstav2:addIn xmlns:vstav2="urn:schemas-microsoft-com:vsta.v2">
<vstav2:entryPoints>
<vstav2:entryPoint class="OutlookAddIn1.ThisAddIn">
<assemblyIdentity
name="OutlookAddIn1"
version="1.0.0.0"
language="neutral"
processorArchitecture="msil" />
</vstav2:entryPoint>
</vstav2:entryPoints>
<vstav2:update enabled="true">
<vstav2:expiration maximumAge="7" unit="days" />
</vstav2:update>
<vstav2:application>
<vstov3:customization
xmlns:vstov3="urn:schemas-microsoft-com:vsto.v3">
<vstov3:appAddIn
application="Outlook"
loadBehavior="3"
keyName="OutlookAddIn1">
<vstov3:friendlyName>
OutlookAddIn1
</vstov3:friendlyName>
<vstov3:description>
OutlookAddIn1 - Outlook add-in created with
Visual Studio Tools for Office
</vstov3:description>
<vstov3:formRegions>
<vstov3:formRegion
name="OutlookAddIn1.FormRegion1">
<vstov3:messageClass name="IPM.Note" />
<vstov3:messageClass name="IPM.Contact" />
<vstov3:messageClass name="IPM.Appointment" />
</vstov3:formRegion>
</vstov3:formRegions>
</vstov3:appAddIn>
</vstov3:customization>
</vstav2:application>
</vstav2:addIn>
Siehe auch
Referenz
Anwendungsmanifeste für Office-Projektmappen (2007 System)
Bereitstellungsmanifeste für Office-Projektmappen (2007 System)