Manifestes d'application pour les solutions Office
Un manifeste d'application est un fichier XML qui décrit les assemblys chargés dans une solution Microsoft Office.Les outils de développement Microsoft Office dans Visual Studio utilisent le schéma du manifeste d'application ClickOnce défini dans la référence Manifeste d'application ClickOnce.
Les manifestes d'application pour les solutions 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 pour les solutions Office possèdent l'élément suivant dans l'espace de noms co.v1.
<entryPoint>
<co.v1:customHostSpecified />
</entryPoint>
Les manifestes d'application possèdent également les é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 Office dans Visual Studio) |
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 |
|
<entryPointsCollection>, élément (Développement Office dans Visual Studio) |
Obligatoire.Regroupe tous les assemblys pour une ou plusieurs solutions Office. |
id |
<entryPoints>, élément (Développement Office dans Visual Studio) |
Obligatoire.Regroupe tous les assemblys pour exécuter une solution Office. |
Aucun |
<entryPoint>, élément (Développement Office dans Visual Studio) |
Obligatoire.Identifie l'assembly à exécuter dans une solution Office. |
class contract |
Obligatoire.Configure des mises à jour pour la solution. |
enabled expiration |
|
<postActions>, élément (Développement Office 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 Office dans Visual Studio) |
Facultatif.Identifie une action de post-déploiement. |
Aucun |
<postActionData>, élément (Développement Office dans Visual Studio) |
Facultatif.Configure les données pour une action de post-déploiement. |
Aucun |
<application>, élément (Développement Office dans Visual Studio) |
Obligatoire.Encapsule les informations spécifiques à l'application dans un nœud unique. |
Aucun |
<customizations>, élément (Développement Office dans Visual Studio) |
Obligatoire.Stocke toutes les informations spécifiques à l'hôte de l'application dans un espace de noms séparé. |
Aucun |
<customization>, élément (Développement Office dans Visual Studio) |
Obligatoire.Stocke les informations spécifiques à l'hôte de l'application dans un espace de noms séparé. |
xmlns |
<document>, élément (Développement Office dans Visual Studio) |
Obligatoire uniquement pour les solutions au niveau du document.Stocke des informations spécifiques à la personnalisation. |
solutionId |
<appAddin>, élément (Développement Office dans Visual Studio) |
Obligatoire uniquement pour les solutions au niveau de l'application.Stocke des informations spécifiques à la personnalisation. |
application loadBehavior keyName |
<friendlyName>, élément (Développement Office dans Visual Studio) |
Facultatif.Stocke le nom du complément qui s'affiche dans la liste des compléments installés. |
Aucun |
<description>, élément (Développement Office dans Visual Studio) |
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 (Développement Office dans Visual Studio) |
Obligatoire uniquement pour les compléments Outlook qui incluent des zones de formulaire. |
Aucun |
<formRegion>, élément (Développement Office dans Visual Studio) |
Obligatoire uniquement pour les compléments Outlook qui incluent des zones de formulaire. |
Name |
<vstoRuntime>, élément (Développement Office dans Visual Studio) |
Obligatoire.Décrit une version spécifique de l'exécution Visual Studio Tools pour Office 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.Après cela, vous devez resigner 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 Comment : signer de nouveau des manifestes d'application et de déploiement.
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