Projektkonfigurations-Objekt
Die Projektkonfiguration Objekt verwaltet die Anzeige von Konfigurationsinformationen der Benutzeroberfläche.
Eigenschaftenseiten Projektkonfiguration
.gif "Visual Studio-Projektkonfiguration")
Der Projektkonfigurations-Anbieter verwaltet die Projektkonfigurationen. Die Umgebung und andere Pakete, zu erhalten und Informationen über die Konfigurationen eines Projekts abrufen, die Schnittstellen aufzurufen Projektkonfigurations-Anbieter an den angehängt werden soll.
Hinweis
Es gibt keine VSIP-Schnittstellen von Projektmappenkonfigurationen programmgesteuert zu erstellen.Es ist keine API zum Bearbeiten der Partner Projektmappenkonfigurationen.Verwenden Sie stattdessen DTE.SolutionBuilder.Weitere Informationen finden Sie unter Projektmappenkonfiguration und Automatisierungs-Modell.
Um einen in der Konfigurationsbenutzeroberfläche zu verwendende Anzeigenamen zu veröffentlichen, sollte das Projekt get_DisplayNameimplementieren. Die Umgebung wird GetCfgsan, die eine Liste von IVsCfg Zeiger zurückgibt, die Sie verwenden können, um die Anzeigenamen zu der in der Benutzeroberfläche angezeigt werden soll Listen Konfiguration und Plattform Informationen abzurufen, der Umgebung. Die aktive Konfiguration und Plattform werden von der Konfiguration des Projekts bestimmt, die in der aktiven Projektmappenkonfiguration gespeichert wird. Die FindActiveProjectCfg-Methode kann verwendet werden, um die aktive Projektkonfiguration abzurufen.
Das IVsProjectCfgProvider-Objekt kann auf dem IVsCfgProvider2-Objekt mit dem IVsCfgProviderEventsHelper-Objekt optional implementiert werden, um Ihnen ermöglichen, ein IVsProjectCfg2-Objekt auf Grundlage den kanonischen Namen der Projektkonfiguration abzurufen.
Eine andere Möglichkeit, die Umgebungen und andere Projekte mit Zugriff auf die Projektkonfigurationen für Projekte bereitzustellen, ist eine Implementierung der IVsCfgProvider2::GetCfgs-Methode bereitstellen, um eine oder mehrere Konfigurationsobjekte zurückzugeben. Die Projekte können auch IVsProjectCfg2Implementieren von IVsProjectCfg und von IVsCfgerbt, um konfigurationsspezifische Informationen bereitzustellen. IVsCfgProvider2 unterstützten Plattformen und Funktionen zum Hinzufügen, Löschen und Umbenennen von Projektkonfigurationen.
Hinweis
Da Visual Studio nicht mehr auf zwei Typen von Konfigurationsinformationen beschränkt ist, sollte der Code nicht verarbeitet, Konfigurationen mit Annahmen über die Anzahl der geschriebenen Konfigurationen sollte weiterhin mit der Annahme geschrieben werden, dass ein Projekt, das nur eine Konfiguration verfügt, notwendigerweise entweder Debug oder im Einzelhandel verkaufen ist.Dies erleichtert die Verwendung von veraltetem get_IsReleaseOnly und get_IsDebugOnly .
Beim Aufrufen QueryInterface für das Objekt, das vonIVsGetCfgProvider::GetCfgProvider zurückgegeben wird, ruft IVsCfgProvider2ab. Wenn IVsGetCfgProvider nicht gefunden wird, indem QueryInterface auf dem IVsProject3 Projektobjekt aufruft, können Sie das Konfigurationsanbieter Objekt zugreifen, indem Sie im QueryInterface Hierarchien stamm-Browser Objekt für das Objekt aufrufen, das für IVsHierarchy::GetProperty(VSITEM_ROOT, VSHPROPID_BrowseObject)oder durch einen Zeiger auf den Konfigurationsanbieter zurückgegeben wird, der für IVsHierarchy::GetProperty(VSITEM_ROOT, VSHPROPID_ConfigurationProvider)zurückgegeben wurde.
IVsProjectCfg2 bietet Zugriff hauptsächlich erstellt, verwaltungsobjekte und Bereitstellung von Projekten und lässt die Freiheit, Ausgaben zu gruppieren. Die Methoden von IVsProjectCfg und IVsProjectCfg2 können verwendet werden, um IVsBuildableProjectCfg , um den Buildprozess zu verwalten und IVsOutputGroup Zeiger für die Ausgabe Gruppen einer Konfiguration zu implementieren.
Das Projekt muss dieselbe Anzahl von Gruppen für jede Konfiguration zurückgegeben werden, die sie unterstützt, obwohl die Anzahl von Ausgaben, die innerhalb einer Gruppe enthaltenen der Konfiguration Konfiguration unterscheidet. Die Gruppen müssen dieselben Informationen zu Bezeichnern und Anzeigenamen (kanonischer Name) von Gruppeninformationen Konfiguration Konfiguration innerhalb eines Projekts haben. Weitere Informationen finden Sie unter Projektkonfiguration für die Ausgabe.
Um das Debuggen zu aktivieren, sind die Konfigurationen IVsDebuggableProjectCfgimplementieren. IVsDebuggableProjectCfg handelt es sich um eine optionale Schnittstelle, die von Projekten zu ermöglichen, dem Debugger zum Starten einer Konfiguration implementiert wird, und wird auf dem Konfigurationsobjekt mit IVsCfg und IVsProjectCfgimplementiert. Die Umgebung wird angezeigt, wenn der Benutzer wählt, um den Debugger zu starten, indem Sie F5 drücken.
ISpecifyPropertyPages und IDispatch werden zusammen mit Eigenschaftenseiten verwendet, um anlagenabhängige Informationen für den Benutzer abzurufen und anzuzeigen. Weitere Informationen finden Sie unter Eigenschaftenseiten.
Siehe auch
Konzepte
Projektkonfiguration zum Erstellen
Projektkonfiguration für die Ausgabe