Partager via


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

Mise à jour : novembre 2007

Remarque

S'applique à

Les informations de cette rubrique s'appliquent uniquement aux projets Visual Studio Tools pour Office et aux 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

  • Version 2007 de Microsoft Office System

Dans une solution Visual Studio Tools pour Office, un manifeste d'application est un fichier XML qui décrit les assemblys chargés dans une solution Microsoft Office.

Visual Studio Tools pour Office utilise le schéma de manifeste d'application de ClickOnce défini dans la référence Manifeste d'application ClickOnce.

Les manifestes d'application Visual Studio Tools pour Office utilisent les éléments et attributs ClickOnce suivants.

Élément

Description

Attributs

<assembly>, élément (Application ClickOnce)

Obligatoire. Élément du niveau le plus haut.

manifestVersion

<assemblyIdentity>, élément (Application ClickOnce)

Obligatoire. Identifie l'assembly principal de l'application ClickOnce.

name

version

publicKeyToken

processorArchitecture

language

<trustInfo>, élément (Application ClickOnce)

Identifie la configuration de sécurité requise de l'application.

Aucun

<entryPoint>, élément (Application ClickOnce)

Obligatoire. Identifie le point d'entrée du code d'application pour l'exécution.

name

dependencyName

customHostSpecified

<dependency>, élément (Application ClickOnce)

Obligatoire. Identifie chaque dépendance requise pour que l'application s'exécute. Identifie éventuellement les assemblys à préinstaller.

Aucun

<file>, élément (Application ClickOnce)

Obligatoire. Identifie chaque fichier (autre qu'un fichier d'assembly) utilisé par l'application. Il peut inclure des données d'isolation COM associées au fichier.

name

size

Les manifestes d'application Visual Studio Tools pour Office possèdent l'élément suivant dans l'espace de noms co.v1.

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

Les manifestes d'application Visual Studio Tools pour Office possèdent également les éléments et attributs suivants dans l'espace de noms vstav2.

<addIn>
    <entryPoints>
        <entryPoint>
        </entryPoint>
    </entryPoints>
    <update></update>
    <application>
        <customization>
        </customization>
    </application
</addIn>

Élément

Description

Attributs

<customHostSpecified>, élément

Obligatoire. Marque spécifiquement le manifeste comme étant une solution Office.

Aucun

<addin>, élément (Office System 2007)

Obligatoire. Stocke des points d'entrée dans un espace de noms unique.

Aucun

<entryPoints>, élément (Office System 2007)

Obligatoire. Regroupe tous les assemblys à exécuter.

Aucun

<entryPoint>, élément (Office System 2007)

Obligatoire. Identifie l'assembly à exécuter.

class

contract

<update>, élément (Office System 2007)

Obligatoire. Configure des mises à jour pour la solution.

enabled

expiration

<application>, élément (Office System 2007)

Obligatoire. Encapsule les informations spécifiques à l'application dans un nœud unique.

Aucun

<customization>, élément (Office System 2007)

Obligatoire. Stocke les informations spécifiques à l'hôte de l'application dans un espace de noms séparé.

xmlns

<document>, élément (Office System 2007)

Obligatoire uniquement pour les solutions au niveau du document. Stocke des informations spécifiques à la personnalisation.

solutionId

<appAddin>, élément (Office System 2007)

Obligatoire uniquement pour les solutions au niveau de l'application. Stocke des informations spécifiques à la personnalisation.

application

loadBehavior

keyName

<friendlyName>, élément (Office System 2007)

Facultatif. Stocke le nom du complément qui s'affiche dans la liste des compléments installés.

Aucun

<description>, élément (Office System 2007)

Obligatoire uniquement pour les compléments d'application. Stocke la description qui s'affiche dans la liste des programmes installés.

Aucun

<formRegions>, élément (Office System 2007)

Obligatoire uniquement pour les compléments Outlook 2007 qui incluent des zones de formulaire.

Aucun

<formRegion>, élément (Office System 2007)

Obligatoire uniquement pour les compléments Outlook 2007 qui incluent des zones de formulaire.

name

Notes

Vous pouvez modifier manuellement les manifestes d'application et de déploiement dans les solutions Visual Studio Tools pour Office. Les manifestes d'application et de déploiement doivent être de nouveau signés par l'outil Manifest Generation and Editing (mage.exe et mageui.exe) après leur modification. Signez d'abord le manifeste d'application, puis le manifeste de déploiement. Pour plus d'informations, consultez Outil Manifest Generation and Editing (Mage.exe) et Manifest Generation and Editing, outil du client graphique (MageUI.exe).

Emplacement du fichier

Un manifeste d'application est spécifique à une seule version d'une solution. Pour cette raison, les manifestes d'application doivent être stockés séparément des manifestes de déploiement. Visual Studio place les fichiers spécifiques à la version dans un sous-répertoire nommé d'après la version associée, lui-même placé dans le sous-répertoire Application Files du dossier de publication.

Syntaxe des noms de fichier

Le nom d'un fichier manifeste d'application doit représenter le nom complet et l'extension de l'application, tel qu'il est identifié dans l'élément assemblyIdentity, suivi de l'extension .manifest. Par exemple, un manifeste d'application qui fait référence à la personnalisation OutlookAddIn1.dll utiliserait la syntaxe suivante.

OutlookAddIn1.dll.manifest

ExcelWorkbook1.dll.manifest

Exemple de personnalisation au niveau du document

Description

L'exemple de code suivant illustre les sections d'un manifeste d'application qui sont spécifiques à une solution Visual Studio Tools pour Office. Il s'agit d'une personnalisation au niveau du document pour Microsoft Office Excel 2007.

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>

Exemple de complément d'application

Description

L'exemple de code suivant illustre les sections d'un manifeste d'application qui sont spécifiques à une solution Visual Studio Tools pour Office. Il s'agit d'un complément d'application de Microsoft Office Outlook 2007 qui inclut une zone de formulaire.

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>

Voir aussi

Référence

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

Manifestes de déploiement pour les solutions Office (Office System 2007)

Manifeste d'application ClickOnce