Strumenti di supporto di Simbolo-Esplorazione

Gli strumenti diVisualizzatore oggetti, di Visualizzazione classi, di Visualizzatore chiamate e di Risultati del simbolo di ricerca forniscono le funzionalità di esplorazione del simbolo in Visual Studio. Questi strumenti vengono visualizzate le visualizzazioni struttura ad albero gerarchico di simboli e mostrano le relazioni tra simboli nella struttura ad albero. I simboli possono rappresentare gli spazi dei nomi, gli oggetti, le classi, i membri della classe e altri elementi del linguaggio contenuti in vari componenti. I componenti includono i progetti di Visual Studio, i componenti esterni di .NET Framework e le librerie dei tipi (TLB). Per ulteriori informazioni, vedere Visualizzazione della struttura del codice.

Librerie di Simbolo-Esplorazione

Come responsabile implementatori di linguaggio, è possibile estendere le funzionalità di simbolo-esplorazione di Visual Studio creando le raccolte che tiene traccia dei simboli nei componenti e forniscono elenchi dei simboli gestione dell'oggetto di Visual Studio tramite un set di interfacce. Una raccolta è descritta dall'interfaccia di IVsSimpleLibrary2 . L'amministratore dell'oggetto di Visual Studio risponde alle richieste di nuovi dati dagli strumenti di simbolo-esplorazione ottenere i dati dalle librerie e organizzandolo. Successivamente inserisce o aggiorna gli strumenti con i dati richiesti. Per ottenere un riferimento all'amministratore dell'oggetto di Visual Studio, IVsObjectManager2, passa il servizio ID di SVsObjectManager al metodo di GetService .

Ogni raccolta necessario registrare con l'amministratore dell'oggetto di Visual Studio, che raccoglie informazioni su tutte le raccolte. Per registrare una libreria, chiamare il metodo di RegisterSimpleLibrary . Secondo lo strumento inizia la richiesta, i trova gestione dell'oggetto di Visual Studio la raccolta appropriato e richiede i dati. I round trip a di dati tra le raccolte e gestione dell'oggetto di Visual Studiogli elenchi dei simboli descritti da IVsSimpleObjectList2 collegamento.

L'amministratore dell'oggetto di Visual Studioè responsabile periodicamente di aggiornamento degli strumenti di simbolo-esplorazione per riflettere i dati più recenti contenuti nelle librerie.

Nel diagramma riportato di seguito contiene un esempio degli elementi principali delle richieste/processo di scambio di dati tra una raccolta e gestione dell'oggetto di Visual Studio. Le interfacce nel diagramma fa parte di un'applicazione di codice gestito.

Per fornire gli elenchi dei simboli in Visual Studio l'oggetto amministratore, è necessario innanzitutto registrare la raccolta con l'amministratore dell'oggetto di Visual Studio chiamando il metodo di RegisterSimpleLibrary . Dopo la raccolta è registrata, l'amministratore dell'oggetto di Visual Studio richiede alcune informazioni sulle funzionalità della raccolta. Ad esempio, richiede i flag della libreria e le categorie supportate chiamando i metodi di GetSupportedCategoryFields2 e di GetLibFlags2 . A un certo punto, quando uno degli strumenti richiede i dati da questa raccolta, l'amministratore dell'oggetto richiede un elenco di primo livello dei simboli chiamando il metodo di GetList2 . Nella risposta, la raccolta fabbrica un elenco di simboli e lo espone gestione dell'oggetto di Visual Studio tramite l'interfaccia di IVsSimpleObjectList2 . L'amministratore dell'oggetto di Visual Studiodetermina il numero di elementi presenti nell'elenco chiamando il metodo di GetItemCount . Tutte le seguenti condizioni sono correlati a un elemento specificato nell'elenco e forniscono il numero di indice dell'elemento in ogni richiesta. L'amministratore dell'oggetto di Visual Studio continua a raccogliere informazioni sul tipo, sull'accessibilità e altre proprietà dell'elemento chiamando il metodo di GetCategoryField2 .

Determina il nome dell'elemento chiamando il metodo di GetTextWithOwnership e richiede informazioni sull'icona chiamando il metodo di GetDisplayData . L'icona viene visualizzata a sinistra del nome dell'elemento e raffigura il tipo di elemento, l'accessibilità e altre proprietà.

L'amministratore dell'oggetto di Visual Studio chiama il metodo di GetExpandable3 per determinare se un elemento dell'elenco specificato è espandibile e ha voci figlio. Se l'interfaccia utente invia una richiesta di espandere un elemento, l'amministratore dell'oggetto richiede un elenco figlio di simboli chiamando il metodo di GetList2 . Il processo continua con diverse parti della struttura ad albero che si trova su richiesta compilato.

Nota

Per implementare un provider del simbolo di codice nativo, utilizzare le interfacce di IVsObjectList2 e di IVsLibrary2 .

Vedere anche

Attività

Procedura: Registrare una libreria con l'amministratore dell'oggetto

Procedura: Elenchi di esporre i simboli forniti dalla libreria gestione dell'oggetto

Procedura: identificare i simboli in una raccolta