Génération de solutions OfficeBuilding Office Solutions

En général, la génération et le débogage de projets Office sont identiques à la génération et au débogage d’autres types de projets dans Visual Studio, tels que les Windows Forms.In general, building and debugging Office projects is the same as building and debugging other types of projects in Visual Studio, such as Windows Forms. Les rubriques de cette section expliquent les différences qui existent.The topics in this section explain the differences that do exist. Pour obtenir des informations générales sur la façon de créer des applications, consultez compilation et génération dans Visual Studio.For general information about how to build applications, see Compiling and Building in Visual Studio.

Note

Vous souhaitez développer des solutions qui étendent l’expérience Office sur plusieurs plateformes?Interested in developing solutions that extend the Office experience across multiple platforms? Découvrez le nouvel modèle des compléments Office.Check out the new Office Add-ins model. Compléments Office ont un faible encombrement mémoire par rapport aux compléments VSTO et les solutions, et vous pouvez les créer à l’aide de presque n’importe quel web technologies, telles que HTML5, JavaScript, CSS3 et XML de programmation.Office Add-ins have a small footprint compared to VSTO add-ins and solutions, and you can build them by using almost any web programming technology, such as HTML5, JavaScript, CSS3, and XML.

Sortie de projet pour les projets OfficeProject Output for Office Projects

L’emplacement de sortie pour les projets Office est nom_projet\bin\release ou nom_projet\bin\debug.The output location for Office projects is projectname\bin\release or projectname\bin\debug. Vous ne pouvez pas générer un projet dans un répertoire de déploiement.You cannot build to a deployment directory.

Projets au niveau du documentDocument-Level Projects

Quand vous générez un projet au niveau du document, les éléments suivants sont inclus dans la sortie du projet :When you build a document-level project, the following items are included in the project output:

  • Une copie du document de projet.A copy of the project document.

  • L’assembly de projet et tous les assemblys référencés dont la propriété Copie locale a la valeur true.The project assembly and all referenced assemblies that have their Copy Local property set to true.

  • Le manifeste de l’application doté de l’extension de nom de fichier .manifest.The application manifest, which has the file name extension .manifest. Pour plus d'informations, consultez Application Manifests for Office Solutions.For more information, see Application Manifests for Office Solutions.

  • Le manifeste de déploiement doté de l’extension de nom de fichier .vsto.The deployment manifest, which has the file name extension .vsto. Pour plus d'informations, consultez Deployment Manifests for Office Solutions.For more information, see Deployment Manifests for Office Solutions.

  • Un fichier de base de données du programme (PDB).A program database (PDB) file.

Note

Si vous générez une solution au niveau du document à un emplacement distant et non pas sur l’ordinateur local, ajoutez le chemin complet de la liste des emplacements approuvés dans le Centre de gestion de la confidentialité de l’application.If you build a document-level solution to a remote location instead of the local computer, add the fully qualified path to the Trusted Locations list in the application's Trust Center. Pour plus d’informations, consultez la section intitulée Octroi de niveaux de confiance à des documents dans Securing Office Solutions.For more information, see the section called Granting Trust to Documents in Securing Office Solutions.

Projets de niveau applicationApplication-Level Projects

Quand vous générez un projet de complément VSTO, les éléments suivants sont inclus dans la sortie du projet :When you build an VSTO Add-in project, the following items are included in the project output:

  • L’assembly de projet et tous les assemblys référencés dont la propriété Copie locale a la valeur true.The project assembly and all referenced assemblies that have their Copy Local property set to true.

  • Le manifeste de l’application doté de l’extension de nom de fichier .manifest.The application manifest, which has the file name extension .manifest. Pour plus d'informations, consultez Application Manifests for Office Solutions.For more information, see Application Manifests for Office Solutions.

  • Le manifeste de déploiement doté de l’extension de nom de fichier .vsto.The deployment manifest, which has the file name extension .vsto. Pour plus d'informations, consultez Deployment Manifests for Office Solutions.For more information, see Deployment Manifests for Office Solutions.

  • Un fichier de base de données du programme (PDB) pour l’assembly du projet.A program database (PDB) file for the project assembly.

    Le processus de génération pour les projets de complément VSTO crée également un jeu d’entrées du Registre sur l’ordinateur de développement, qui sont requises pour charger le complément VSTO.The build process for VSTO Add-in projects also creates a set of registry entries on the development computer that are required to load the VSTO Add-in. Pour plus d'informations, consultez Registry Entries for VSTO Add-ins.For more information, see Registry Entries for VSTO Add-ins.

    Si vous générez un projet de complément VSTO Outlook qui contient des zones de formulaire, le processus de génération ajoute les informations supplémentaires suivantes dans le Registre :If you build an Outlook VSTO Add-in project that contains form regions, the build process adds the following additional information to the registry:

  • une clé pour chaque classe de message associée à une ou plusieurs zones de formulaire,A key for each message class that is associated with one or more form regions.

  • une entrée pour chaque zone de formulaire et une valeur associée représentant le nom du complément VSTO Outlook.An entry for each form region and an associated value that represents the name of the Outlook VSTO Add-in.

    Outlook a besoin de ces informations pour charger les zones de formulaire.Outlook needs this information to load the form regions.

Assemblys référencésReferenced Assemblies

Vous pouvez référencer des assemblys (y compris des projets de bibliothèque de classes) à partir de votre projet de génération de solutions Office.You can reference assemblies (including class library projects) from your Building Office Solutions project. Chaque assembly référencé possède une propriété appelée Copie locale.Every referenced assembly has a property called Copy Local. Copie locale indique si l’assembly est copié vers le répertoire de sortie.Copy Local indicates whether the assembly is copied to the output directory. Elle a la valeur truepar défaut.By default it is set to true. Chaque assembly référencé dont la propriété Copie locale a la valeur true est copié dans le répertoire de sortie.Every referenced assembly that has Copy Local set to true is copied to the output directory.

Sécurité pendant le processus de générationSecurity during the Build Process

Visual Studio configure automatiquement les paramètres de sécurité sur l’ordinateur de développement afin d’accorder un niveau de confiance à la solution pendant le processus de génération.Visual Studio automatically configures the security settings on the development computer to grant trust to the solution during the build process. Cela permet d’exécuter la solution pendant que vous la déboguez.This allows the solution to run while you debug it.

Les projets Office utilisent des certificats pour vérifier l’éditeur.Office projects use certificates to verify the publisher. Visual Studio crée automatiquement un certificat temporaire pour identifier les solutions Office et configure l’ordinateur de développement pour approuver ce certificat.Visual Studio automatically creates a temporary certificate to identify Office solutions, and configures the development computer to trust the temporary certificate.

Pour plus d'informations, consultez Securing Office Solutions.For more information, see Securing Office Solutions.

Projets en réseauNetwork Projects

Si l’assembly ou le document se trouve sur un partage réseau, la mise à jour de la stratégie de sécurité locale (niveau utilisateur) ne suffit pas pour permettre à la solution de s’exécuter.If the assembly or document location is on a network share, the local (User level) security policy update is not enough to allow the solution to run. Un administrateur doit accorder une confiance totale au niveau de l’ordinateur aux assemblys et documents situés sur un partage réseau avant que la solution ne s’exécute.An administrator must grant full trust at the Machine level to assemblies and documents that are on a network share before the solution will run. Pour plus d’informations sur la façon de définir la stratégie de sécurité, consultez Securing Office Solutions.For more information about how to set security policy, see Securing Office Solutions.

Pour les projets au niveau du document, vous devez également ajouter l’emplacement complet du document dans la liste des dossiers approuvés d’Office.For document-level projects, you must also add the fully qualified location of the document to the Office trusted folders list. Pour plus d'informations, consultez Granting Trust to Documents.For more information, see Granting Trust to Documents.

Modification de la plateforme cibleChanging the Platform Target

Par défaut, la plateforme cible pour les projets Office est Any CPU.By default, the platform target for Office projects is Any CPU. En règle générale, vous ne devez pas modifier ce paramètre.Typically, you should not change this setting. Les solutions Office générées avec le paramètre de plateforme cible Any CPU s’exécutent dans les versions 32 bits et 64 bits de Microsoft Office 2013Office 2013 ou Office 2010Office 2010.Office solutions that are built with the Any CPU platform target setting run in 32-bit and 64-bit versions of Microsoft Office 2013Office 2013 or Office 2010Office 2010.

Vous devez spécifier la plateforme cible x64 seulement si vous créez une solution destinée à s’exécuter uniquement dans les versions 64 bits de Microsoft Office 2013Office 2013 ou Office 2010Office 2010, et que votre solution appelle des API 64 bits natives.You should set the platform target to x64 only if you are creating a solution that will run only in 64-bit versions of Microsoft Office 2013Office 2013 or Office 2010Office 2010, and your solution calls native 64-bit APIs. Pour plus d’informations sur la modification du paramètre de la plateforme cible, consultez Comment : configurer des projets pour des plateformes cibles.For more information about changing the platform target setting, see How to: Configure Projects to Target Platforms.

Si vous spécifiez la plateforme cible x64, la solution ne s’exécutera pas dans les versions 32 bits de Windows et Office.If you set the platform target to x64, the solution will not run in 32-bit versions of Windows or Office. La plateforme cible x64 exige que la solution s’exécute dans un processus 64 bits.The x64 platform target requires the solution to run in a 64-bit process.

Utilisation de la commande NettoyerUsing the Clean Command

Pour supprimer les fichiers projet générés de l’ordinateur de développement, vous pouvez utiliser la commande Nettoyer du menu Générer dans Visual StudioVisual Studio.To remove the built project files from the development computer, you can use the Clean command on the Build menu in Visual StudioVisual Studio. La commande Nettoyer supprime tous les fichiers de l’emplacement de sortie de la génération.The Clean command deletes all files in the build output location. Pour les projets de niveau application, la commande Nettoyer supprime également les entrées de Registre créées par le processus de génération.For application-level projects, the Clean command also removes the registry entries that are created by the build process.

TitreTitle DescriptionDescription
Débogage de projets OfficeDebugging Office Projects Présente des problèmes liés au débogage de projets Office.Presents issues involved in debugging Office projects.
Procédure pas à pas : création de votre première personnalisation au niveau du document pour ExcelWalkthrough: Creating Your First Document-Level Customization for Excel Montre comment créer une personnalisation de base au niveau du document pour Excel.Demonstrates how to create a basic document-level customization for Excel.
Guide pratique pour réactiver un complément VSTO qui a été désactivéHow to: Re-enable a VSTO Add-in That Has Been Disabled Décrit comment réactiver un complément VSTO qui a été désactivé de manière forcée ou en douceur.Describes how to re-enable an VSTO Add-in that has been hard or soft disabled.
Conception et création de solutions OfficeDesigning and Creating Office Solutions Fournit des liens vers des informations concernant la création de solutions Office et le rôle des assemblys dans ces solutions.Provides links to information about creating Office solutions, and about the role of assemblies in your solution.