Manifestes d’application pour les solutions Bureau
Un manifeste d’application est un fichier XML qui décrit les assemblys qui sont chargés dans une solution Microsoft Office. Les outils de développement Microsoft Bureau dans Visual Studio utilisent le schéma de manifeste d’application ClickOnce défini dans la référence du manifeste de l’application ClickOnce.
Les manifestes d’application pour les solutions Bureau utilisent les éléments et attributs ClickOnce suivants.
| Élément | Description | Attributs |
|---|---|---|
| <assembly> , élément (Application ClickOnce) | Obligatoire. Élément de niveau supérieur. | 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 les exigences de sécurité de l’application. | Aucun |
| <entryPoint,> élément (application ClickOnce) | Obligatoire. Identifie le point d’entrée de code d’application pour l’exécution. | name dependencyName customHostSpecified |
| <dependency> , élément (Application ClickOnce) | Obligatoire. Identifie chaque dépendance requise pour l’exécution de l’application. Identifie éventuellement les assemblys qui doivent être préinstallés. | Aucun |
| <file> , élément (Application ClickOnce) | Obligatoire. Identifie chaque fichier non assembly utilisé par l’application. Peut inclure les données d’isolation COM (Component Object Model) associées au fichier. | name size |
Les manifestes d’application pour solutions Office disposent de l’élément suivant dans l’espace de noms co.v1 .
<entryPoint>
<co.v1:customHostSpecified />
</entryPoint>
Ces manifestes d’application disposent aussi des éléments et attributs suivants dans l’espace de noms vstav3 .
<addIn>
<entryPointsCollection>
<entryPoints>
<entryPoint>
</entryPoint>
</entryPoints>
</entryPointsCollection>
<update></update>
<postActions>
<postAction>
<postActionData>
</postActionData>
<postAction>
</postActions>
<application>
<customizations>
<customization>
</customization>
</customizations>
</application
</addIn>
| Élément | Description | Attributs |
|---|---|---|
| <customHostSpecified>, élément (développement Bureau dans Visual Studio) | Obligatoire. Marque le manifeste précisément comme une solution Office. | Aucun |
| <addin>, élément (développement Bureau dans Visual Studio) | Obligatoire. Stocke les points d’entrée dans un espace de noms unique. | Aucun |
| <entryPointsCollection>, élément (développement Bureau dans Visual Studio) | Obligatoire. Regroupe tous les assemblys pour une ou plusieurs solutions Office. | id |
| <entryPoints>, élément (développement Bureau dans Visual Studio) | Obligatoire. Regroupe tous les assemblys pour exécuter une solution Office. | Aucun |
| <entryPoint,> élément (développement Bureau dans Visual Studio) | Obligatoire. Identifie l’assembly à exécuter dans une solution Office. | class Contrat |
| <update>, élément (développement Bureau dans Visual Studio) | Obligatoire. Configure les mises à jour pour la solution. | activé expiration |
| <postActions>, élément (développement Bureau dans Visual Studio) | facultatif. Regroupe toutes les actions de post-déploiement qui s’exécutent après l’installation des solutions Office. | Aucun |
| <postAction,> élément (développement Bureau dans Visual Studio) | facultatif. Identifie une action de post-déploiement. | Aucun |
| <postActionData,> élément (développement Bureau dans Visual Studio) | facultatif. Configure les données pour une action de post-déploiement. | Aucun |
| <application>, élément (développement Bureau dans Visual Studio) | Obligatoire. Encapsule les informations spécifiques à l’application dans un même nœud. | Aucun |
| <élément personnalisations> (développement Bureau dans Visual Studio) | Obligatoire. Stocke toutes les informations spécifiques à l’hôte de l’application dans un espace de noms distinct. | Aucun |
| <élément de personnalisation> (développement Bureau dans Visual Studio) | Obligatoire. Stocke les informations spécifiques à l’hôte de l’application dans un espace de noms distinct. | xmlns |
| <document>, élément (développement Bureau dans Visual Studio) | Obligatoire uniquement pour les solutions au niveau du document. Stocke les informations spécifiques à la personnalisation. | solutionId |
| <appAddin>, élément (développement Bureau dans Visual Studio) | Obligatoire uniquement pour les solutions au niveau de l’application. Stocke les informations spécifiques à la personnalisation. | application Loadbehavior keyName |
| <friendlyName>, élément (développement Bureau dans Visual Studio) | facultatif. Stocke le nom du complément VSTO qui figure dans la liste des compléments VSTO installés. | Aucun |
| <élément description> (développement Bureau dans Visual Studio) | Obligatoire uniquement pour les compléments VSTO. Stocke la description qui apparaît dans la liste des programmes installés. | Aucun |
| <formRegions>, élément (développement Bureau dans Visual Studio) | Obligatoire uniquement pour les compléments VSTO Outlook qui incluent des zones de formulaire. | Aucun |
| <formRegion>, élément (développement Bureau dans Visual Studio) | Obligatoire uniquement pour les compléments VSTO Outlook qui incluent des zones de formulaire. | Nom |
| <vstoRuntime>, élément (Bureau développement dans Visual Studio) | Obligatoire. Décrit la version spécifique de Visual Studio Tools pour Office Runtime qui est prise en charge par la solution Office. | release version supportUrl |
Notes
Vous pouvez modifier manuellement les manifestes d’application et de déploiement dans les solutions Office. Ensuite, vous devez signer à nouveau les manifestes d’application et de déploiement à l’aide de l’Outil Manifest Generation and Editing (mage.exe et mageui.exe). Pour plus d’informations, consultez Guide pratique pour resigner des manifestes de déploiement et d’application.
Emplacement du fichier
Un manifeste d’application est propre à une seule version d’une solution. Pour cette raison, les manifestes d’application doivent être stockés à l’écart des manifestes de déploiement. Visual Studio place les fichiers spécifiques à la version dans un sous-répertoire nommé après la version associée dans le sous-répertoire Fichiers d’application dans le dossier de publication.
Syntaxe du nom de fichier
Le nom d’un fichier manifeste d’application doit être le nom complet et l’extension de l’application, comme identifié dans l’élément assemblyIdentity , suivi de l’extension .manifest. Par exemple, un manifeste d’application qui fait référence à la personnalisation d’OutlookAddIn1.dll utilise la syntaxe de nom de fichier suivante.
OutlookAddIn1.dll.manifest