Anwendungsmanifeste für Office-Projektmappen (2003 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 finden Sie unter Verfügbare Features nach Anwendung und Projekttyp.

Projekttyp

  • Projekte auf Dokumentebene

  • Projekte auf Anwendungsebene

Microsoft Office-Version

  • Microsoft Office 2003

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 2003-Projektmappe geladen werden. Bei Anpassungen auf Dokumentebene wird eine Kopie des Anwendungsmanifests in das Projektmappendokument eingebettet. Eine weitere Kopie verbleibt auf dem Bereitstellungsserver, um die Aktualisierung der Projektmappe zu vereinfachen. In Add-Ins auf Anpassungsebene befindet sich eine Kopie des Anwendungsmanifests auf dem Clientcomputer. Eine weitere Kopie verbleibt auf dem Bereitstellungsserver, um die Aktualisierung der Projektmappe zu vereinfachen. Weitere Informationen finden Sie unter Bereitstellen von Anpassungen auf Dokumentebene (2003 System) und unter Bereitstellen von Add-Ins auf Anwendungsebene (2003 System).

Visual Studio Tools for Office verwendet ein Anwendungsmanifestschema, das dem für ClickOnce definierten Schema ähnelt. Nur in dieser Tabelle aufgelistete Elemente und Attribute werden für Visual Studio Tools for Office-Projektmappen unterstützt. Alle Elemente und Attribute, die Teil des ClickOnce-Schemas sind, aber nicht aufgelistet wurden, werden ignoriert, ohne dass ein Fehler ausgelöst wird.

Anwendungsmanifeste verfügen über die folgenden Elemente und Attribute.

Element

Beschreibung

Attribute

<assembly>-Element (Referenz für Visual Studio Tools for Office)

Erforderlich. Oberstes Element.

manifestVersion

<assemblyIdentity>-Element (Referenz für Visual Studio Tools for Office)

Erforderlich. Identifiziert die Version des Anwendungsmanifests und beschreibt abhängige Assemblys.

name

version

publicKeyToken

language

<entryPoint>-Element (Referenz für Visual Studio Tools for Office)

Erforderlich. Identifiziert den Anwendungscodeeinstiegspunkt für die Ausführung.

name

dependencyName

<dependency>-Element (Referenz für Visual Studio Tools for Office)

Erforderlich. Identifiziert die zum Ausführen der Anwendung erforderlichen Abhängigkeiten. Identifiziert optional Assemblys, die vorinstalliert werden müssen.

name

<dependentAssembly>-Element (Referenz für Visual Studio Tools for Office)

Erforderlich. Stellt Informationen zu abhängigen Assemblys bereit.

Keine

<installFrom>-Element (Referenz für Visual Studio Tools for Office)

Erforderlich. Gibt bei Verwendung als untergeordnetes Element des dependency-Elements den Pfad zum Bereitstellungsort unabhängiger Assemblys an. Bei Verwendung als untergeordnetes Element des assembly-Elements gibt es den Ort des Bereitstellungsmanifests an.

codebase

<clrClassInvocation>-Element (Referenz für Visual Studio Tools for Office)

Erforderlich. Gibt die Klasse an, die für ein entryPoint-Element aufgerufen werden muss.

class

Hinweise

Die Assemblys können nur zwischengespeichert werden, wenn der Servername im Pfad zu den Assemblys ausschließlich in Kleinbuchstaben geschrieben wird.

Jedes Mal, wenn Sie ein Visual Studio Tools for Office-Projekt erstellen, wird ein Anwendungsmanifest generiert und in das Dokument eingebettet (für Anpassungen auf Dokumentebene) oder im Buildausgabeordner abgelegt (für Add-Ins auf Anwendungsebene). Beim Veröffentlichen einer Projektmappe mit dem Webpublishing-Assistenten wird im Ausgabeordner ebenfalls eine Kopie des Anwendungsmanifests erstellt und dann in das Veröffentlichungsziel kopiert. Das Anwendungsmanifest wird von der Visual Studio Tools for Office-Aufgabe GenerateAndPersistAppInfoTask und nicht von der MSBuild-Aufgabe GenerateApplicationManifest generiert.

Ein Anwendungsmanifest ist nur für eine einzelne Version einer bereitgestellten Projektmappe bestimmt. Aus diesem Grund müssen Anwendungsmanifeste getrennt von Bereitstellungsmanifesten gespeichert werden. Im Allgemeinen wird das Anwendungsmanifest in einem Unterverzeichnis platziert, das nach der zugewiesenen Version benannt ist. Weitere Informationen finden Sie unter Bereitstellen von Anpassungen auf Dokumentebene (2003 System) und unter Bereitstellen von Add-Ins auf Anwendungsebene (2003 System).

Anwendungs- und Bereitstellungsmanifeste werden in Visual Studio Tools for Office-Projektmappen nicht wie ClickOnce-Manifeste signiert. Die Manifeste können vor der Verwendung nicht überprüft werden.

Einige der von den Veröffentlichungstools generierten Felder in Anwendungs- und Bereitstellungsmanifesten werden in Visual Studio Tools for Office-Projektmappen nicht verwendet. Das gilt auch für einige Felder, die die Eigenschaften der Assembly identifizieren, z. B. deren Größe und Version.

Dateinamensyntax

Der Name einer Anwendungsmanifestdatei muss mit dem im assemblyIdentity-Element identifizierten Namen identisch sein und die Erweiterung .manifest aufweisen. Beispielsweise verwendet ein auf die Projektmappe ExcelApplication1 verweisendes Anwendungsmanifest die folgende Dateinamensyntax.

excelapplication1.manifest

Beispiel

Im folgenden Codebeispiel wird ein Anwendungsmanifest für eine Visual Studio Tools for Office-Projektmappe veranschaulicht.

<?xml version="1.0" encoding="utf-8"?>
<assembly manifestVersion="1.0" 
    xmlns:asmv2="urn:schemas-microsoft-com:asm.v2"
    xmlns="urn:schemas-microsoft-com:asm.v1"
    xmlns:asm.v2="urn:schemas-microsoft-com:asm.v2"
    xmlns:ds="http://www.w3.org/2000/09/xmldsig#"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation=
       "urn:schemas-microsoft-com:asm.v1 manifest.2.0.0.9.adaptive.xsd"
>

    <assemblyIdentity name="Project1.manifest" 
        version="1.0.1.1"/>
    <asm.v2:entryPoint name="Startup" dependencyName="Project1">
        <asm.v2:clrClassInvocation class="Sheet1"/>
    </asm.v2:entryPoint>
    <asm.v2:entryPoint name="Startup" dependencyName="Project1">
        <asm.v2:clrClassInvocation class="Sheet2"/>
    </asm.v2:entryPoint>
    <asm.v2:entryPoint name="Startup" dependencyName="Project1">
        <asm.v2:clrClassInvocation class="Sheet3"/>
    </asm.v2:entryPoint>
    <dependency asmv2:name="Project1">
        <dependentAssembly>
            <assemblyIdentity name="Project1" 
                version="1.0.1.1"/>
        </dependentAssembly>
        <asmv2:installFrom codebase=
            "http://deployweb/project1/project1_1.0.1.1/project1.dll"/>
    </dependency>
    <asm.v2:installFrom codebase=
        "http://deployweb/project1/project1.application"/>
</assembly>

Siehe auch

Aufgaben

Gewusst wie: Programmgesteuertes Aktualisieren von Pfaden für Anwendungsmanifestassemblys (2003 System)

Gewusst wie: Entfernen verwalteter Codeerweiterungen aus Dokumenten (2003 System)

Konzepte

Anwendungs- und Bereitstellungsmanifeste in Office-Projektmappen

Übersicht über Laufzeitspeicher-Steuerelemente

Referenz

Bereitstellungsmanifeste für Office-Projektmappen (2003 System)