Oggetto di configurazione del progetto
L'oggetto di configurazione del progetto gestisce la visualizzazione di informazioni di configurazione all'interfaccia utente.
Pagine delle proprietà di configurazione del progetto
.gif "Configurazione di progetto Visual Studio")
Il provider di configurazione del progetto gestisce le configurazioni del progetto. L'ambiente e altri pacchetti, accedere a e recuperare le informazioni sulle configurazioni di un progetto, chiamare le interfacce associate all'oggetto provider di configurazione del progetto.
Nota
Non sono disponibili interfacce di VSIP per creare configurazioni di soluzione a livello di codice.Non esiste VSIP API per modificare le configurazioni di soluzione.È necessario utilizzare DTE.SolutionBuilder.Per ulteriori informazioni, vedere Configurazione di soluzione e modello di automazione.
Per pubblicare un nome visualizzato da utilizzare nell'interfaccia utente di configurazione, il progetto deve implementare get_DisplayName. The environment calls GetCfgs, which returns a list of IVsCfg pointers that you can use to get the display names for the Configuration and Platform information to be listed in the environment's UI. La configurazione e la piattaforma attiva vengono determinate dalla configurazione del progetto archiviata nella configurazione di soluzione attiva. Il metodo di FindActiveProjectCfg può essere utilizzato per recuperare la configurazione del progetto attiva.
L'oggetto di IVsProjectCfgProvider facoltativamente può essere implementato dall'oggetto IVsCfgProvider2 con l'oggetto di IVsCfgProviderEventsHelper per consentire di recuperare un oggetto di IVsProjectCfg2 in base al nome canonico di configurazione del progetto.
Un altro modo per fornire l'ambiente e altri progetti con accesso alle configurazioni di progetto è per i progetti di fornire un'implementazione del metodo di IVsCfgProvider2::GetCfgs per restituire uno o più oggetti di configurazione. The projects may also implement IVsProjectCfg2, which inherits from IVsProjectCfg and thereby from IVsCfg, to provide configuration-specific information. IVsCfgProvider2 supporta le piattaforme e la funzionalità per l'aggiunta, l'eliminazione e rinominare le configurazioni di progetto.
Nota
Poiché Visual Studio non è più limitato a due tipi di configurazione, il codice che le configurazioni di processi non devono essere scritte con le ipotesi relative al numero di configurazioni, né deve essere scritti presupponendo che un progetto che contiene una singola configurazione è necessariamente Debug o finale.Ciò consente l'utilizzo di get_IsReleaseOnly e di get_IsDebugOnly obsoleti.
Chiamando QueryInterface sull'oggetto restituitodaIVsGetCfgProvider::GetCfgProvider recupera IVsCfgProvider2. Se IVsGetCfgProvider non viene trovato chiamando QueryInterface sull'oggetto del progetto di IVsProject3 , è possibile accedere all'oggetto del provider di configurazione chiamando QueryInterface sull'oggetto del browser radice della gerarchia per l'oggetto restituito per IVsHierarchy::GetProperty(VSITEM_ROOT, VSHPROPID_BrowseObject), o tramite un puntatore al provider di configurazione restituito per IVsHierarchy::GetProperty(VSITEM_ROOT, VSHPROPID_ConfigurationProvider).
IVsProjectCfg2 principalmente fornisce l'accesso per compilare, eseguire il debug e oggetto di gestione di distribuzione e concede a progetti la libertà raggruppare gli output. I metodi di IVsProjectCfg e di IVsProjectCfg2 possono essere utilizzati per implementare IVsBuildableProjectCfg per gestire il processo di compilazione e i puntatori di IVsOutputGroup per i gruppi di output di configurazione.
Il progetto deve restituire lo stesso numero dei gruppi per ogni configurazione che supporta anche se il numero di output contenuti all'interno di un gruppo può variare dalla configurazione della configurazione. I gruppi devono essere le stesse informazioni dell'identificatore (nome, nome visualizzato e informazioni canonici del gruppo) dalla configurazione alla configurazione all'interno di un progetto. Per ulteriori informazioni, vedere Configurazione del progetto per l'output.
Per abilitare il debug, le configurazioni devono implementare IVsDebuggableProjectCfg. IVsDebuggableProjectCfg è un'interfaccia opzionale implementata dai progetti consentire al debugger di avviare la configurazione e distribuito sull'oggetto di configurazione con IVsCfg e IVsProjectCfg. L'ambiente la chiamata quando l'utente sceglie di avviare il debugger premendo F5.
ISpecifyPropertyPages e IDispatch vengono utilizzati insieme alle pagine delle proprietà per recuperare e visualizzare le informazioni dell'utente. Per ulteriori informazioni, vedere Pagine delle proprietà.
Vedere anche
Concetti
Configurazione del progetto per la compilazione
Configurazione del progetto per l'output