Manifestes d'application pour les solutions Office (Office System 2003)

Article
08/21/2008

Mise à jour : novembre 2007

Remarque	S'applique à
Les informations dans cette rubrique s'appliquent uniquement aux projets Visual Studio Tools pour Office et versions de Microsoft Office spécifiés. Pour plus d'informations, consultez Fonctionnalités disponibles par type d'application et de projet.	Type de projet Projets au niveau du document Projets au niveau de l'application Version de Microsoft Office Microsoft Office 2003

Les informations dans cette rubrique s'appliquent uniquement aux projets Visual Studio Tools pour Office et versions de Microsoft Office spécifiés.

Pour plus d'informations, consultez Fonctionnalités disponibles par type d'application et de projet.

Type de projet

Projets au niveau du document
Projets au niveau de l'application

Version de Microsoft Office

Microsoft Office 2003

Dans une solution Visual Studio Tools pour Office, un manifeste d'application est un fichier XML qui décrit des assemblys chargés dans une solution Microsoft Office 2003. Dans les personnalisations au niveau du document, un exemplaire du manifeste d'application est incorporé dans le document de la solution. Un autre est conservé sur le serveur de déploiement pour faciliter la mise à jour de la solution. Dans les compléments au niveau de l'application, un exemplaire du manifeste d'application se trouve sur l'ordinateur client. Un autre est conservé sur le serveur de déploiement pour faciliter la mise à jour de la solution. Pour plus d'informations, consultez Déploiement de personnalisations au niveau du document (Office System 2003) et Déploiement de compléments d'application (Office System 2003).

Visual Studio Tools pour Office utilise un schéma de manifeste d'application semblable au schéma défini pour ClickOnce. Seuls les éléments et attributs répertoriés dans cette table sont pris en charge pour les solutions Visual Studio Tools pour Office. Tous les éléments et attributs qui font partie du schéma ClickOnce mais ne sont pas répertoriés ici sont ignorés, sans déclenchement d'erreur.

Les manifestes d'application ont les éléments et attributs suivants.

Élément	Description	Attributs
<assembly>, élément (Référence d'application Visual Studio Tools pour Office)	Obligatoire. Élément du niveau le plus haut.	manifestVersion
<assemblyIdentity>, élément (Référence Visual Studio Tools pour Office)	Obligatoire. Identifie la version du manifeste d'application et décrit les assemblys dépendants.	name version publicKeyToken language
<entryPoint>, élément (Référence Visual Studio Tools pour Office)	Obligatoire. Identifie le point d'entrée du code d'application pour l'exécution.	name dependencyName
<dependency>, élément (Référence Visual Studio Tools pour Office)	Obligatoire. Identifie chaque dépendance requise pour que l'application s'exécute. Identifie éventuellement les assemblys à préinstaller.	name
<dependentAssembly>, élément (Référence Visual Studio Tools pour Office)	Obligatoire. Fournit des informations sur les assemblys dépendants.	None (Aucun)
<installFrom>, élément (Référence Visual Studio Tools pour Office)	Obligatoire. Fournit un chemin d'accès à l'emplacement de déploiement des assemblys dépendants en cas d'utilisation en tant qu'enfant d'un élément dependency, et à l'emplacement du manifeste de déploiement en cas d'utilisation en tant qu'enfant de l'élément assembly.	codebase
<clrClassInvocation>, élément (Référence Visual Studio Tools pour Office)	Obligatoire. Indique la classe à appeler pour un élément entryPoint.	class

Notes

Le nom du serveur doit être entièrement en minuscules dans le chemin d'accès aux assemblys, sinon les assemblys ne sont pas mis en cache.

Un manifeste d'application est généré et incorporé dans le document (pour les personnalisations au niveau du document) ou placé dans le dossier de sortie de la génération (pour les compléments au niveau de l'application) chaque fois que vous créez un projet Visual Studio Tools pour Office. Lorsque vous publiez une solution à l'aide de l'Assistant Publication, un exemplaire du manifeste d'application est également créé dans le dossier de sortie, puis copié dans la destination de la publication. La tâche Visual Studio Tools pour OfficeGenerateAndPersistAppInfoTask génère le manifeste d'application, la tâche MSBuildGenerateApplicationManifest ne le fait pas.

Un manifeste d'application est spécifique à une seule version d'une solution déployée. Pour cette raison, les manifestes d'application doivent être stockés séparément des manifestes de déploiement. Il est généralement convenu de placer le manifeste d'application dans un sous-répertoire prenant le nom de la version associée. Pour plus d'informations, consultez Déploiement de personnalisations au niveau du document (Office System 2003) et Déploiement de compléments d'application (Office System 2003).

Les manifestes d'application et de déploiement ne sont pas signés dans les solutions Visual Studio Tools pour Office, alors que les manifestes de ClickOnce le sont. Les manifestes ne peuvent pas être validés avant d'être utilisés.

Certains des champs des manifestes d'application et de déploiement générés par les outils de publication ne sont pas utilisés dans les solutions Visual Studio Tools pour Office. C'est le cas de certains champs identifiant des propriétés d'un assembly, telles que la taille et la version.

Syntaxe des noms de fichiers

Un fichier manifeste d'application doit porter le nom de l'application, tel qu'il est identifié dans l'élément assemblyIdentity, suivi de l'extension .manifest. Par exemple, le nom de fichier d'un manifeste d'application faisant référence à la solution ExcelApplication1 utiliserait la syntaxe suivante.

excelapplication1.manifest

Exemple

L'exemple de code suivant illustre un manifeste d'application pour une solution Visual Studio Tools pour Office.

<?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>

Voir aussi

Partager via

Manifestes d'application pour les solutions Office (Office System 2003)

Notes

Syntaxe des noms de fichiers

Exemple

Voir aussi

Tâches

Concepts

Référence

Ressources supplémentaires