Configuration de la solutionSolution Configuration

Les configurations de solution stockent les propriétés au niveau de la solution.Solution configurations store solution-level properties. Elles indiquent le comportement de la Démarrer touche (F5) et générer commandes.They direct the behavior of the Start (F5) key and Build commands. Par défaut, ces commandes générer et démarrer la configuration debug.By default, these commands build and start the debug configuration. Les deux commandes s’exécutent dans le contexte d’une configuration de solution.Both commands execute in the context of a solution configuration. Cela signifie que l’utilisateur peut attendre F5 pour démarrer et quelle que soit la solution active est configurée via les paramètres de build.This means that the user can expect F5 to start and build whatever the active solution is configured through the settings. L’environnement est conçu pour optimiser pour les solutions plutôt que des projets en matière de création et l’exécution.The environment is designed to optimize for solutions rather than projects when it comes to building and running.

La barre d’outils standard de Visual Studio contient un bouton de démarrage et une liste déroulante à droite du bouton Démarrer de configuration de solution.The standard Visual Studio toolbar contains a Start button and a solution configuration drop-down to the right of the Start button. Cette liste permet aux utilisateurs de choisir la configuration doit être démarré lorsque vous appuyez sur F5, créer leurs propres configurations de solutions ou modifier une configuration existante.This list allows users to choose the configuration to be started when F5 is pressed, create their own solution configurations, or edit an existing configuration.

Note

Il n’existe aucune interface d’extensibilité pour créer ou modifier les configurations de solution.There are no extensibility interfaces to create or edit the solution configurations. Vous devez utiliser DTE.SolutionBuilder.You must use DTE.SolutionBuilder. Toutefois, il existe API d’extensibilité pour la gestion de la génération de la solution.However, there are extensibility APIs for managing the solution build. Pour plus d'informations, consultez IVsSolutionBuildManager2.For more information, see IVsSolutionBuildManager2.

Voici comment vous pouvez implémenter les configurations de solution prise en charge par votre type de projet :Here is how you can implement the solution configurations supported by your project type:

  • ProjetProject

    Affiche les noms des projets de la solution actuelle.Displays the names of projects found in the current solution.

  • ConfigurationConfiguration

    Pour fournir la liste des configurations prises en charge par votre type de projet et affichés dans les pages de propriétés, implémenter IVsCfgProvider2.To provide the list of configurations supported by your project type and displayed in the property pages, implement IVsCfgProvider2.

    La colonne Configuration affiche le nom de la configuration de projet à générer dans cette configuration de solution et répertorie toutes les configurations de projet lorsque vous cliquez sur le bouton fléché.The Configuration column displays the name of the project configuration to build in this solution configuration, and lists all of the project configurations when you click the arrow button. L’environnement appelle le GetCfgNames méthode pour remplir cette liste.The environment calls the GetCfgNames method to fill out this list. Si le GetCfgProviderProperty méthode indique que le projet prend en charge la modification de configuration, nouveau ou modifier les sélections sont également affichées sous l’en-tête de la Configuration.If the GetCfgProviderProperty method indicates that the project supports configuration editing, New or Edit selections are also displayed under the Configuration heading. Chacune de ces sélections lancer des boîtes de dialogue qui appellent des méthodes de la IVsCfgProvider2 interface pour modifier les configurations du projet.Each of these selections launch dialog boxes that call methods of the IVsCfgProvider2 interface to edit the project's configurations.

    Si un projet ne prend pas en charge les configurations, la colonne Configuration affiche aucun et est désactivée.If a project does not support configurations, the Configuration column displays None and is disabled.

  • PlateformePlatform

    Affiche la plateforme de la configuration de projet sélectionné pour les builds et répertorie toutes les plateformes disponibles pour le projet lorsque vous cliquez sur le bouton fléché.Displays the platform the selected project configuration builds for, and lists all of the available platforms for the project when you click the arrow button. L’environnement appelle le GetPlatformNames méthode pour remplir cette liste.The environment calls the GetPlatformNames method to fill out this list. Si le GetCfgProviderProperty méthode indique que le projet prend en charge la modification de la plateforme, nouveau ou modifier les sélections sont également affichées sous l’en-tête de la plateforme.If the GetCfgProviderProperty method indicates that the project supports platform editing, New or Edit selections are also displayed under the Platform heading. Chacune de ces sélections lancer des boîtes de dialogue qui appellent IVsCfgProvider2 méthodes pour modifier les plateformes disponibles du projet.Each of these selections launch dialog boxes that call IVsCfgProvider2 methods to edit the project's available platforms.

    Si un projet ne prend pas en charge les plateformes, la colonne de plateforme pour ce projet affiche aucun et est désactivée.If a project does not support platforms, the platform column for that project displays None and is disabled.

  • GénérerBuild

    Spécifie si le projet est généré par la configuration actuelle de la solution.Specifies whether or not the project is built by the current solution configuration. Projets non sélectionnés ne sont pas générés lorsque les commandes de génération au niveau de la solution sont appelées en dépit de toutes les dépendances de projet qu’ils contiennent.Unselected projects are not built when the solution-level build commands are invoked despite any project dependencies they contain. Projets non sélectionnés pour être générés sont toujours inclus dans le débogage en cours d’exécution, empaquetage et déploiement de la solution.Projects not selected to be built are still included in debugging, running, packaging, and deployment of the solution.

  • DéployerDeploy

    Spécifie si le projet doit être déployé lorsque les commandes de démarrage ou de déployer sont utilisés avec la configuration de build de solution sélectionnée.Specifies whether or not the project will be deployed when the Start or Deploy commands are used with the selected solution build configuration. La case à cocher pour ce champ sera disponible si le projet prend en charge le déploiement en implémentant la IVsDeployableProjectCfg interface sur son IVsProjectCfg2 objet.The check box for this field will be available if the project supports deploying by implementing the IVsDeployableProjectCfg interface on its IVsProjectCfg2 object.

    Une fois qu’une nouvelle configuration de solution est ajoutée, l’utilisateur peut sélectionner dans la zone de liste déroulante de Configuration de Solution sur la barre d’outils standard à générer et/ou à démarrer cette configuration.Once a new solution configuration is added, the user can select it from the Solution Configuration drop-down list box on the standard toolbar to build and/or start that configuration.

Voir aussiSee Also

Gestion des Options de Configuration Managing Configuration Options
Configuration de projet pour la génération Project Configuration for Building
Objet de configuration de projetProject Configuration Object