Manifestes d'application pour les solutions Office

Article
08/10/2011

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
<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 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
<addin>, élément (Développement Office dans Visual Studio)	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
<update>, élément (Développement Office dans Visual Studio)	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 2007 qui incluent des zones de formulaire.	Aucun
<formRegion>, élément (Développement Office dans Visual Studio)	Obligatoire uniquement pour les compléments Outlook 2007 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

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. Cet exemple décrit une personnalisation au niveau du document pour Microsoft Office Excel 2007.

Code

<entryPoint>
    <co.v1:customHostSpecified />
</entryPoint> 
[...]
<vstav3:addIn 
  xmlns:vstav3="urn:schemas-microsoft-com:vsta.v3">
  <vstav3:entryPointsCollection>
    <vstav3:entryPoints>
      <vstav3:entryPoint 
        class="ContosoExcelWorkbook.ThisWorkbook">
        <assemblyIdentity 
          name="ContosoExcelWorkbook" 
          version="1.0.0.0" 
          language="neutral" 
          processorArchitecture="msil" />
      </vstav3:entryPoint>
      <vstav3:entryPoint 
        class="ContosoExcelWorkbook.Sheet1">
        <assemblyIdentity 
          name="ContosoExcelWorkbook" 
          version="1.0.0.0" 
          language="neutral" 
          processorArchitecture="msil" />
      </vstav3:entryPoint>
      <vstav3:entryPoint 
        class="ContosoExcelWorkbook.Sheet2">
        <assemblyIdentity 
          name="ContosoExcelWorkbook" 
          version="1.0.0.0" 
          language="neutral" 
          processorArchitecture="msil" />
      </vstav3:entryPoint>
      <vstav3:entryPoint 
        class="ContosoExcelWorkbook.Sheet3">
        <assemblyIdentity 
          name="ContosoExcelWorkbook" 
          version="1.0.0.0" 
          language="neutral" 
          processorArchitecture="msil" />
      </vstav3:entryPoint>
    </vstav3:entryPoints>
  </vstav3:entryPointsCollection>
  <vstav3:update 
    enabled="true">
    <vstav3:expiration 
      maximumAge="7" 
      unit="days" />
  </vstav3:update>
  <vstav3:application>
    <vstov4:customizations 
      xmlns:vstov4="urn:schemas-microsoft-com:vsto.v4">
      <vstov4:customization>
        <vstov4:document 
          solutionId="73e" />
      </vstov4:customization>
    </vstov4:customizations>
  </vstav3:application>
</vstav3: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. Cet exemple décrit un complément d'application de Microsoft Office Outlook 2007 qui inclut une zone de formulaire.

Code

<entryPoint>
    <co.v1:customHostSpecified />
</entryPoint> 
[...]
<vstav3:addIn 
  xmlns:vstav3="urn:schemas-microsoft-com:vsta.v3">
  <vstav3:entryPointsCollection>
    <vstav3:entryPoints>
      <vstav3:entryPoint 
        class="ContosoOutlookAddIn.ThisAddIn">
        <assemblyIdentity 
          name="ContosoOutlookAddIn" 
          version="1.0.0.0" 
          language="neutral" 
          processorArchitecture="msil" />
      </vstav3:entryPoint>
    </vstav3:entryPoints>
  </vstav3:entryPointsCollection>
  <vstav3:update 
    enabled="true">
    <vstav3:expiration 
      maximumAge="7" 
      unit="days" />
  </vstav3:update>
  <vstav3:application>
    <vstov4:customizations 
      xmlns:vstov4="urn:schemas-microsoft-com:vsto.v4">
      <vstov4:customization>
        <vstov4:appAddIn 
          application="Outlook" 
          loadBehavior="3" 
          keyName="ContosoOutlookAddIn">
          <vstov4:friendlyName>
            ContosoOutlookAddIn
          </vstov4:friendlyName>
          <vstov4:description>
            ContosoOutlookAddIn - Outlook add-in 
            created with Visual Studio Tools for Office
          </vstov4:description>
          <vstov4:formRegions>
            <vstov4:formRegion
                name="OutlookAddIn1.FormRegion1">
              <vstov4:messageClass name="IPM.Note" />
              <vstov4:messageClass name="IPM.Contact" />
              <vstov4:messageClass name="IPM.Appointment" />
            </vstov4:formRegion>
          </vstov4:formRegions>
        </vstov4:appAddIn>
      </vstov4:customization>
    </vstov4:customizations>
  </vstav3:application>
</vstav3:addIn>

Exemple de déploiement multi-projet

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. Cet exemple décrit un déploiement multi-projet qui installe un complément d'application de Microsoft Outlook 2007 avec une zone de formulaire et une personnalisation au niveau du document Microsoft Excel 2007.

Code

  <entryPoint>
    <co.v1:customHostSpecified />
  </entryPoint>
[...]
  <dependency>
    <dependentAssembly 
      dependencyType="install" 
      allowDelayedBinding="true" 
      codebase="ContosoExcelWorkbook.dll" 
      size="12800">
      <assemblyIdentity 
        name="ContosoExcelWorkbook" 
        version="1.0.0.0" 
        language="neutral" 
        processorArchitecture="msil" />
      <hash>
        <dsig:Transforms>
          <dsig:Transform Algorithm=
            "urn:schemas-microsoft-com:HashTransforms.Identity" />
        </dsig:Transforms>
        <dsig:DigestMethod Algorithm=
            "http://www.w3.org/2000/09/xmldsig#sha1" />
        <dsig:DigestValue>ONF</dsig:DigestValue>
      </hash>
    </dependentAssembly>
  </dependency>
  <dependency>
    <dependentAssembly 
      dependencyType="install" 
      allowDelayedBinding="true" 
      codebase="ContosoOutlookAddIn.dll" 
      size="10240">
      <assemblyIdentity 
        name="ContosoOutlookAddIn" 
        version="1.0.0.0" 
        language="neutral" 
        processorArchitecture="msil" />
      <hash>
        <dsig:Transforms>
          <dsig:Transform Algorithm=
            "urn:schemas-microsoft-com:HashTransforms.Identity" />
        </dsig:Transforms>
        <dsig:DigestMethod Algorithm=
            "http://www.w3.org/2000/09/xmldsig#sha1" />
        <dsig:DigestValue>i4e</dsig:DigestValue>
      </hash>
    </dependentAssembly>
  </dependency>
  <vstav3:addIn 
    xmlns:vstav3="urn:schemas-microsoft-com:vsta.v3">
    <vstav3:entryPointsCollection>
      <vstav3:entryPoints 
        id="ContosoExcel">
        <vstav3:entryPoint 
          class="ContosoExcelWorkbook.ThisWorkbook">
          <assemblyIdentity 
            name="ContosoExcelWorkbook" 
            version="1.0.0.0" 
            language="neutral" 
            processorArchitecture="msil" />
        </vstav3:entryPoint>
        <vstav3:entryPoint 
          class="ContosoExcelWorkbook.Sheet1">
          <assemblyIdentity 
            name="ContosoExcelWorkbook" 
            version="1.0.0.0" 
            language="neutral" 
            processorArchitecture="msil" />
        </vstav3:entryPoint>
        <vstav3:entryPoint 
          class="ContosoExcelWorkbook.Sheet2">
          <assemblyIdentity 
            name="ContosoExcelWorkbook" 
            version="1.0.0.0" 
            language="neutral" 
            processorArchitecture="msil" />
        </vstav3:entryPoint>
        <vstav3:entryPoint 
          class="ContosoExcelWorkbook.Sheet3">
          <assemblyIdentity 
            name="ContosoExcelWorkbook" 
            version="1.0.0.0" 
            language="neutral" 
            processorArchitecture="msil" />
        </vstav3:entryPoint>
      </vstav3:entryPoints>
      <vstav3:entryPoints 
        id="ContosoOutlook">
        <vstav3:entryPoint 
          class="ContosoOutlookAddIn.ThisAddIn">
          <assemblyIdentity 
            name="ContosoOutlookAddIn" 
            version="1.0.0.0" 
            language="neutral" 
            processorArchitecture="msil" />
        </vstav3:entryPoint>
      </vstav3:entryPoints>
    </vstav3:entryPointsCollection>
    <vstav3:update 
      enabled="true">
      <vstav3:expiration 
        maximumAge="7" 
        unit="days" />
    </vstav3:update>
    <vstav3:application>
      <vstov4:customizations 
        xmlns:vstov4="urn:schemas-microsoft-com:vsto.v4">
        <vstov4:customization 
          id="ContosoExcel">
          <vstov4:document 
            solutionId="73ec4ba9-a983-40b3-af63-5fb172ea81db" />
        </vstov4:customization>
        <vstov4:customization 
          id="ContosoOutlook">
          <vstov4:appAddIn 
            application="Outlook" 
            loadBehavior="3" 
            keyName="ContosoOutlookAddIn">
            <vstov4:friendlyName>
              ContosoOutlookAddIn
            </vstov4:friendlyName>
            <vstov4:description>
              ContosoOutlookAddIn - Outlook add-in created with 
              Visual Studio Tools for Office
            </vstov4:description>
          </vstov4:appAddIn>
        </vstov4:customization>
      </vstov4:customizations>
    </vstav3:application>
  </vstav3:addIn>

Exemple d'actions de post-déploiement

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. Cet exemple décrit une action de post-déploiement qui crée une clé de Registre une fois l'installation terminée.

Code

<vstav3:postActions>
  <vstav3:postAction>
    <vstav3:entryPoint 
      class="PostDeploymentAction.PostDeploymentActionSample">
      <assemblyIdentity 
        name="PostDeploymentAction" 
        version="1.0.0.0" 
        language="neutral" 
        processorArchitecture="msil" />
    </vstav3:entryPoint>
    <vstav3:postActionData>
    </vstav3:postActionData>
  </vstav3:postAction>
</vstav3:postActions>

Voir aussi

Référence

Manifestes de déploiement pour les solutions Office

Manifeste d'application ClickOnce

Partager via

Manifestes d'application pour les solutions Office

Notes

Emplacement du fichier

Syntaxe des noms de fichier

Exemple de personnalisation au niveau du document

Description

Code

Exemple de complément d'application

Description

Code

Exemple de déploiement multi-projet

Description

Code

Exemple d'actions de post-déploiement

Description

Code

Voir aussi

Référence

Ressources supplémentaires