objet de configuration de projet
l'objet de configuration de projet gère l'affichage des données de configuration à l'interface utilisateur.
pages de propriétés de configuration de projet
.gif "Configuration de projet Visual Studio")
le fournisseur de configuration de projet gère les configurations de projet. L'environnement et d'autres packages, à laquelle accéder et récupérer des informations sur les configurations d'un projet, appelez les interfaces jointes à l'objet fournisseur de configuration de projet.
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 configuration de solution et modèle Automation.
Pour publier un nom complet à utiliser dans la configuration interface utilisateur, votre projet doit implémenter get_DisplayName. L'environnement appelle l' GetCfgs, qui retourne la liste des pointeurs d' IVsCfg que vous pouvez utiliser pour obtenir les noms complets pour les informations de configuration et de plateforme apparaissent dans l'interface utilisateur de l'environnement. La configuration active et la plateforme sont déterminées par la configuration du projet stockée dans la configuration de solution active. La méthode d' FindActiveProjectCfg peut être utilisée pour récupérer la configuration de projet active.
L'objet d' IVsProjectCfgProvider peut éventuellement être implémenté dans l'objet d' IVsCfgProvider2 avec l'objet d' IVsCfgProviderEventsHelper pour vous permettre de récupérer un objet d' IVsProjectCfg2 en fonction de le nom canonique de configuration de projet.
Une autre façon de fournir à l'environnement et à d'autres projets l'accès aux configurations de projet consiste à ce que les projets fournissent une implémentation de la méthode de IVsCfgProvider2::GetCfgs pour retourner un ou plusieurs objets de configuration. Les projets peuvent également implémenter IVsProjectCfg2, qui hérite d' IVsProjectCfg et donc d' IVsCfg, pour fournir des informations de configuration. IVsCfgProvider2 prend en charge les plateformes, et les fonctionnalités pour ajouter, supprimer, renommer et des configurations de projet.
Notes
Étant donné que Visual Studio n'est plus limité à deux types de configuration, le code que les configurations de processus ne doivent pas être écrites avec des hypothèses sur le nombre de configurations, ni ne doit pas être écrit avec l'hypothèse qu'un projet à une seule configuration sont nécessairement débogage ou commerciale.Cela rend l'utilisation d' get_IsReleaseOnly et d' get_IsDebugOnly obsolètes.
appelant QueryInterface sur l'objet retournéd'IVsGetCfgProvider::GetCfgProvider extrait IVsCfgProvider2. Si IVsGetCfgProvider est introuvable en appelant QueryInterface sur l'objet de projet d' IVsProject3 , vous pouvez accéder à l'objet fournisseur de configuration en appelant QueryInterface sur l'objet de navigateur racine de la hiérarchie pour l'objet retourné pour IVsHierarchy::GetProperty(VSITEM_ROOT, VSHPROPID_BrowseObject), ou via un pointeur au fournisseur de configuration retournée pour IVsHierarchy::GetProperty(VSITEM_ROOT, VSHPROPID_ConfigurationProvider).
IVsProjectCfg2 principalement fournit un accès permettant de générer, déboguer et objet de gestion de déploiement et permet aux projets la liberté de regrouper des sorties. Les méthodes d' IVsProjectCfg et d' IVsProjectCfg2 peuvent être utilisées pour implémenter IVsBuildableProjectCfg pour gérer le processus de génération, et les pointeurs d' IVsOutputGroup pour les groupes de sortie d'une configuration.
Le projet doit retourner le même nombre de groupes pour chaque configuration qu'il prend en charge même si le nombre de sorties contenues dans un groupe peut varier de la configuration à la configuration. Les groupes doivent également avoir les mêmes informations d'identificateur (nom canonique, nom entier, informations de groupe) de la configuration à la configuration dans un projet. Pour plus d'informations, consultez configuration de projet pour la sortie.
Pour activer le débogage, les configurations doivent implémenter IVsDebuggableProjectCfg. IVsDebuggableProjectCfg est une interface facultative implémentée par les projets de permettre au débogueur d'exécuter une configuration et est implémenté dans l'objet de configuration avec IVsCfg et IVsProjectCfg. L'environnement l'appelle lorsque l'utilisateur choisit de démarrer le débogueur en appuyant sur F5.
ISpecifyPropertyPages et IDispatch sont utilisés conjointement à des pages de propriétés pour récupérer et afficher les informations dépendantes de la configuration à l'utilisateur. Pour plus d'informations, consultez Pages de propriétés.
Voir aussi
Concepts
configuration de projet pour générer
configuration de projet pour la sortie