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
Version de Microsoft Office
|
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 |
|---|---|---|
Obligatoire. Élément du niveau le plus haut. |
manifestVersion |
|
Obligatoire. Identifie l'assembly principal de l'application ClickOnce. |
name version publicKeyToken processorArchitecture language |
|
Identifie la configuration de sécurité requise de l'application. |
Aucun |
|
Obligatoire. Identifie le point d'entrée du code d'application pour l'exécution. |
name dependencyName customHostSpecified |
|
Obligatoire. Identifie chaque dépendance requise pour que l'application s'exécute. Identifie éventuellement les assemblys à préinstaller. |
Aucun |
|
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 |
|---|---|---|
Obligatoire. Marque spécifiquement le manifeste comme étant une solution Office. |
Aucun |
|
Obligatoire. Stocke des points d'entrée dans un espace de noms unique. |
Aucun |
|
Obligatoire. Regroupe tous les assemblys à exécuter. |
Aucun |
|
Obligatoire. Identifie l'assembly à exécuter. |
class contract |
|
Obligatoire. Configure des mises à jour pour la solution. |
enabled expiration |
|
Obligatoire. Encapsule les informations spécifiques à l'application dans un nœud unique. |
Aucun |
|
Obligatoire. Stocke les informations spécifiques à l'hôte de l'application dans un espace de noms séparé. |
xmlns |
|
Obligatoire uniquement pour les solutions au niveau du document. Stocke des informations spécifiques à la personnalisation. |
solutionId |
|
Obligatoire uniquement pour les solutions au niveau de l'application. Stocke des informations spécifiques à la personnalisation. |
application loadBehavior keyName |
|
Facultatif. Stocke le nom du complément qui s'affiche dans la liste des compléments installés. |
Aucun |
|
Obligatoire uniquement pour les compléments d'application. Stocke la description qui s'affiche dans la liste des programmes installés. |
Aucun |
|
Obligatoire uniquement pour les compléments Outlook 2007 qui incluent des zones de formulaire. |
Aucun |
|
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)