Partager via


configuration de solution

Les propriétés de niveau de solution bank de configurations de solutions et un élément clé du modèle utilisateur de Visual Studio . Plus important encore, ils dirigent le comportement de la clé d' Start (F5) et les commandes d' Build . Les deux commandes exécutent dans le contexte d'une configuration de solution. Cela signifie que l'utilisateur peut s'attendre à ce que F5 démarre et génère l'erreur celui que la solution active soit configurée par les paramètres. L'environnement est conçu pour l'optimisation pour les solutions plutôt que des projets lorsqu'il s'agit de génération et exécuté.

La capture d'écran suivante affiche les propriétés de configuration par défaut pour une solution.

propriétés de configuration de solution

par défaut, le comportement de F5 et de génération dans Visual Studio est identique à celui de Visual Studio 6,0 ; autrement dit, les nouveaux builds par défaut et/ou démarrage de la solution la configuration debug.

La barre d'outils de Visual Studio standard contient un bouton Démarrer (situé au point de menu ? dans la configuration par défaut de Visual Studio) et la zone de liste déroulante configurations de solution à droite du bouton Démarrer. Cette liste déroulante permet par défaut aux utilisateurs de sélectionner la configuration debug et Release à démarrer lors F5 est enfoncé. L'utilisateur peut également accéder au gestionnaire de configurations (décrite plus loin dans cette rubrique) dans la liste déroulante pour créer des options de configuration supplémentaires.

L'élément sélectionné dans la liste déroulante configurations de barre d'outils indique la configuration de solution active. Dans le cas de capture d'écran suivante, la configuration active est version indiquant que la version affiche dans la fenêtre de configuration de la barre d'outils.

L'utilisateur peut également sélectionner la configuration à démarrer lors F5 est enfoncé de affiche de liste déroulante de configuration dans la page de propriétés de configuration de solution dans la capture d'écran précédent. (La gros plan d'Un dans la liste déroulante configurations de page de propriétés est affichée dans la capture d'écran suivante.)

Configuration de solution à la zone de liste déroulante de configuration

la zone de liste déroulante de configuration contient une liste de toutes les configurations disponibles pour la solution. Lorsqu'une nouvelle solution est créée, la liste déroulante Configuration de la solution active contient les entrées suivantes par défaut :

  • Actif (debug)

    Notes

    la configuration entre parenthèses varient selon la configuration active actuellement sélectionnée.

  • Débogage

  • Version commerciale

  • toutes les configurations

Les utilisateurs peuvent créer leurs propres configurations de solution pour générer des configurations de projet spécifiques, pour installer le déploiement logique et physique, et sélectionner le projet de démarrage ou des projets en ouvrant le gestionnaire de configuration en cliquant sur le bouton de gestionnaire de configuration sur la solution ou la page de propriétés du projet, ou en sélectionnant le gestionnaire de configuration de la liste déroulante en regard de le bouton de génération sur la barre d'outils.

Notes

Il n'existe aucune interface de VSIP pour créer des configurations de solutions par programme.Il n'existe aucune API de VSIP pour modifier les configurations de solution.Vous devez utiliser DTE.SolutionBuilder.Pour plus d'informations, consultez modèle Automation.Toutefois, il existe des API de VSIP pour gérer la build de solution.Pour plus d'informations, consultez IVsSolutionBuildManager2.

Gestionnaire de configurations

De la configuration de solution active de sous disponible de liste déroulante, vous pouvez sélectionner des configurations de solutions existantes l'une d'elles. Sinon, vous pouvez créer une configuration de solution en sélectionnant Nouveau dans la liste déroulante et en fournissant un nouveau nom de configuration et la configuration existante dont pour copier les paramètres d'origine. Après que la nouvelle configuration de solution est nommée, vous pouvez sélectionner que les configurations de projet que vous souhaitez générer.

Vous pouvez modifier les configurations de projet existantes en sélectionnant la modification de la liste déroulante du gestionnaire de configuration. Cela vous permet de supprimer ou renommer des configurations existantes.

Le gestionnaire de configuration vous permet de définir des configurations de projet de démarrage notamment :

  • Projet

    Affiche les noms des projets trouvent dans la solution actuelle

  • Configuration

    Pour fournir la liste de configurations prises en charge par votre projet tapez au clavier et vous êtes affiche les pages de propriétés, implémentent IVsCfgProvider2.

    La colonne de configuration affiche le nom de la configuration de projet pour générer dans cette configuration de solution, et répertorie toutes les configurations de projet lorsque vous cliquez sur le bouton fléché. L'environnement appelle la méthode d' GetCfgNames pour exécuter cette liste. Si la méthode d' GetCfgProviderProperty indique que le projet prend en charge la modification de configuration, sélections de nouvelles ou de modification sont également affichées sous l'en-tête de configuration. chacune de ces sélections lance les boîtes de dialogue qui appellent des méthodes d'interface d' IVsCfgProvider2 pour modifier les configurations du projet.

    Si un projet ne prend pas en charge les configurations, la colonne de configuration n'en affiche aucun et est désactivée.

  • Plateforme

    Affiche la plateforme que la configuration de projet sélectionnée génère l'erreur pour, et répertorie toutes les plateformes disponibles pour le projet lorsque vous cliquez sur le bouton fléché. L'environnement appelle la méthode d' GetPlatformNames pour exécuter cette liste. Si la méthode d' GetCfgProviderProperty indique que le projet prend en charge la modification de plateforme, sélections de nouvelles ou de modification sont également affichées sous l'en-tête de plateforme. chacune de ces sélections lance les boîtes de dialogue qui appellent des méthodes d' IVsCfgProvider2 pour modifier les plateformes disponibles du projet.

    Si un projet ne prend pas en charge les plateformes, la colonne de plateforme pour les affichages de ce projet aucun et est désactivée.

  • Générer

    Spécifie si le projet est généré par la configuration de solution active. Les projets non sélectionnés ne sont pas générés lorsque les commandes de génération de solution-niveau sont appelées en dépit de toutes les dépendances du projet qu'ils contiennent. Ces projets sont néanmoins inclus dans les processus de débogage, d'exécution, d'empaquetage et de déploiement de la solution.

  • Déploiement

    Spécifie si le projet est déployé lorsque le début ou déploie des commandes sont utilisés avec la configuration de build de solution sélectionnée. la case à cocher pour ce champ sera disponible si le projet prend en charge le déploiement en implémentant l'interface d' IVsDeployableProjectCfg sur son objet d' IVsProjectCfg2 .

Une fois qu'une configuration de solution est ajoutée, l'utilisateur peut la sélectionner dans la zone de liste déroulante configurations de solutions dans la barre d'outils standard pour générer et/ou commencer cette configuration.

Voir aussi

Concepts

configuration de projet pour générer

objet de configuration de projet

Autres ressources

gérer des options de configuration