Panoramica

L'estensione VisualStudio.Extensibility Diagnostics Explorer è progettata per facilitare il debug delle estensioni VisualStudio.Extensibility durante lo sviluppo. Il gruppo di destinatari di questa estensione è costituito dagli autori di estensioni, non dai consumer di estensioni. Questa estensione fornisce un'interfaccia per esaminare i punti di estendibilità con cui le estensioni interagiscono e quali estensioni degli oggetti di configurazione forniscono all'IDE e i metadati di tali oggetti di configurazione.

Operazioni preliminari

Seguire queste istruzioni per installare, avviare e configurare Diagsnotics Explorer.

Installare l'estensione

È possibile ottenere Esplora diagnostica direttamente tramite Gestione estensioni in Visual Studio o da Visual Studio Marketplace qui.

Nota

L'estensione VisualStudio.Extensibility Diagnostics Explorer è compatable con Visual Studio 2022 17.10 e versioni successive.

Aprire Esplora diagnostica in Visual Studio

Per avviare Esplora diagnostica in Visual Studio, selezionare VisualStudio.Extensibility Diagnostics Explorer nel menu Estensioni .

Screenshot del comando che apre la finestra degli strumenti dell'estensione.

Abilitare la raccolta di diagnostica

Esplora diagnostica è configurato per raccogliere i dati di diagnostica pertinenti dalle estensioni per impostazione predefinita. Se si desidera disabilitare o riabilitare questa raccolta dati, è possibile attivare o disattivare la casella di controllo Abilita raccolta diagnostica nell'angolo inferiore sinistro della finestra degli strumenti. Per rendere effettive le modifiche apportate a questa impostazione, è necessario riavviare Visual Studio.

Screenshot dell'impostazione

Pagine di diagnostica

Il pannello a sinistra della finestra degli strumenti Esplora diagnostica contiene un elenco di pagine di funzionalità diverse. Queste pagine corrispondono alle funzionalità estendibili per le quali è possibile trovare informazioni di diagnostica sui componenti e le configurazioni individuate da Visual Studio dalle estensioni. Ad esempio, è possibile selezionare Comandi per visualizzare la diagnostica relativa ai comandi, ai set di comandi, ai menu e alle barre degli strumenti, ai posizionamenti e altro ancora.

Nell'elenco sono inoltre presenti due pagine speciali che non sono direttamente correlate ad alcun componente dell'estensione: eventi, un visualizzatore live per eventi correlati all'estendibilità e vincoli di attivazione, che mostra lo stato dell'IDE pertinente per facilitare la creazione dei vincoli di attivazione.

Screenshot del pannello a sinistra della finestra degli strumenti.

Pagine delle funzionalità estendibili

Le pagine delle funzionalità estendibili hanno un controllo ComboBox in alto a sinistra per i diversi punti di estendibilità in tale area di funzionalità, ognuno dei quali può essere mappato direttamente agli oggetti di configurazione nell'estensione. Nella pagina Comandi, ad esempio, è presente un punto di estendibilità per menu e barre degli strumenti, che mostra ognuno dei menu e delle barre degli strumenti individuati da Visual Studio nelle estensioni di VisualStudio.Extensibility.

Gli aggiornamenti dei dati in tempo reale man mano che le proprietà vengono aggiornate nelle estensioni. Ad esempio, se un'estensione modifica il nome visualizzato di uno dei relativi comandi in fase di esecuzione, il nuovo nome visualizzato di tale comando viene visualizzato nella cella nella colonna Nome visualizzato per tale comando immediatamente.

Screenshot della pagina Comandi.

Extensibility Point ComboBox include anche un elemento denominato Log, che mostra una visualizzazione in tempo reale di tali aggiornamenti. Il pulsante Cancella tutto accanto a ComboBox può essere utilizzato per cancellare tutte le righe attualmente visualizzate nella visualizzazione.

Screenshot della pagina Log del comando.

È possibile filtrare gli elementi nella visualizzazione usando il controllo ComboBox Estensioni . Quando in questo controllo ComboBox è selezionato Tutto , vengono visualizzati i dati per ogni estensione VisualStudio.Extensibility installata. Se si imposta comboBox sull'ID di un'estensione specifica, vengono visualizzati solo gli elementi correlati a tale estensione specifica. Il valore di questo controllo ComboBox viene salvato in modo permanente anche quando si passa tra pagine di funzionalità estendibili.

Screenshot della pagina del comando filtrata in base a un'estensione specifica.

Alcune celle nella visualizzazione DataGrid [Fare clic per espandere]. Questo messaggio indica che i metadati correlati a tale proprietà sono troppo verbosi per essere visualizzati accuratamente in una cella di DataGrid. Facendo clic sulla cella viene aperta una finestra di dialogo modale che visualizza il valore effettivo di tale cella.

Screenshot della finestra di dialogo modale

Pagina Eventi

La pagina degli eventi mostra quando si verifica un evento nell'IDE. Ogni evento viene visualizzato come nuova riga in DataGrid, insieme a tutte le proprietà correlate a tale evento. Ad esempio, quando viene eseguito un comando, viene visualizzato un evento Commands - Executing nella visualizzazione che mostra l'ID dell'estensione a cui appartiene il comando e l'ID del comando eseguito.

È possibile utilizzare il controllo ComboBox eventi per filtrare la visualizzazione in modo che contenga solo eventi con un nome specifico. Quando è selezionata l'opzione Tutti , vengono visualizzati tutti gli eventi. Se viene selezionato un evento specifico, tutte le proprietà dell'evento vengono visualizzate nella visualizzazione. Alcune proprietà devono essere espanse facendo clic su [Fare clic su Espandi] se sono troppo dettagliate per essere visualizzate in una singola cella.

Il controllo ComboBox contratto filtra la visualizzazione in modo da visualizzare solo gli eventi correlati a una funzionalità estendibile specifica. Filtra anche comboBox Event in modo che contenga solo i nomi degli eventi correlati alla funzionalità estendibile specifica.

Facendo clic sul pulsante Cancella tutto vengono eliminati tutti gli eventi attualmente visualizzati nella visualizzazione.

Screenshot della pagina Eventi.

Descrizioni delle colonne

ID estensione

La colonna Id estensione mostra l'ID dell'estensione a cui è correlata l'istanza dell'evento. È possibile che questa cella sia vuota per alcuni eventi se non appartengono a un'estensione specifica, ma si applicano all'IDE nel suo complesso.

ID articolo

La colonna ID elemento mostra l'ID dell'elemento di estensione a cui è correlata l'istanza dell'evento. Ad esempio, l'ID elemento per l'evento Commands - Executing sarà l'ID del comando eseguito.

Proprietà

La colonna Proprietà mostra il set di proprietà correlate all'istanza dell'evento che può essere visualizzato in una singola cella in un oggetto DataGrid. Le proprietà più dettagliate saranno visibili solo dalla finestra di dialogo Altre informazioni o modificando Il controllo ComboBox eventi con il nome dell'evento specifico a cui si è interessati.

Altre informazioni

Nella colonna Altre informazioni vengono visualizzati più metadati dettagliato correlati a un evento. Facendo clic su una cella in questa colonna viene aperta una finestra di dialogo modale contenente tutti i metadati correlati all'evento rappresentato da tale riga.

Screenshot della finestra di dialogo Altre informazioni.

Pagina Vincoli di attivazione

La pagina vincoli di attivazione mostra lo stato di varie proprietà correlate all'IDE stesso. Context ComboBox modifica i dati nella visualizzazione in modo da visualizzare tutti i vincoli di attivazione correlati all'elemento attualmente selezionato in Acitvation Constraints ComboBox oppure un log di tutte le volte in cui queste proprietà sono state modificate dopo l'apertura della finestra degli strumenti. Quando si seleziona il contesto Eventi , è possibile utilizzare il pulsante Cancella tutto per eliminare tutti gli eventi attualmente visualizzati nella visualizzazione.

Screenshot della pagina Stato corrente del vincolo di attivazione.

Screenshot della pagina Eventi del vincolo di attivazione.