Visualizzare e modificare i valori delle variabili con Suggerimenti dati nell'editor di codice
Questo articolo illustra come usare la funzionalità Suggerimenti dati in Visual Studio. I suggerimenti per i dati offrono un modo pratico per visualizzare informazioni sulle variabili nel programma durante il debug del codice. Quando si impostano punti di interruzione nel codice e si avvia il debug, i suggerimenti dati sono visibili per le variabili quando immettono l'ambito di esecuzione corrente. È possibile usare il suggerimento dati per modificare il valore di una variabile nell'ambito ed eseguire di nuovo il codice sul punto di interruzione per visualizzare l'effetto della modifica.
Suggerimento
Se non si ha familiarità con il debug, è possibile leggere Debug per principianti assoluti e tecniche e strumenti di debug prima di usare questo articolo.
Prerequisiti
Visual Studio. Se Visual Studio non è disponibile, passare alla pagina dei download di Visual Studio per installarlo gratuitamente.
Codice del programma da eseguire nel debugger di Visual Studio.
Usare i suggerimenti per i dati
I suggerimenti dati sono visibili durante una sessione di debug quando nel codice sono impostati punti di interruzione. Quando il debugger sospende l'esecuzione del programma in un punto di interruzione, i suggerimenti dati sono disponibili per tutte le variabili nell'ambito corrente.
È necessario eseguire le operazioni seguenti:
Impostare un punto di interruzione nel codice e avviare il debug selezionando Debug>Avvia debug oppure usare il tasto di scelta rapida F5.
Quando il debugger sospende l'esecuzione in corrispondenza del punto di interruzione, passare il puntatore del mouse su qualsiasi variabile nell'ambito corrente per aprire la descrizione dati.
Usare la descrizione dati per visualizzare il nome della variabile e usare il valore .
Se necessario, modificare il valore per una variabile o aggiungere commenti.
Nota
Visual Studio valuta e visualizza il valore della variabile in una descrizione dati in base al contesto in cui il debugger viene sospeso durante l'esecuzione. La valutazione non è basata sulla posizione corrente del cursore o della descrizione dati. Se si passa il puntatore del mouse su una variabile in un'altra funzione con lo stesso nome di una variabile nel contesto corrente, Visual Studio visualizza il valore della variabile nella descrizione dati per il contesto corrente.
Visual Studio supporta molte azioni per i suggerimenti sui dati e l'uso delle variabili e dei valori, tra cui:
- Aggiungere o float un suggerimento per i dati per mantenerlo visibile man mano che l'esecuzione del codice continua
- Abilitare suggerimenti per i dati permanenti che rimangono espansi fino a quando non si seleziona altrove
- Espandere la descrizione dati per una matrice, una struttura o un oggetto per visualizzarne i membri in un formato albero
- Modificare il valore di una variabile in un suggerimento dati
- Aggiungere commenti su più righe a un suggerimento per i dati aggiunti per prendere nota durante il debug
- Importare ed esportare suggerimenti per i dati
Rendere trasparenti i suggerimenti per i dati
Quando si passa il puntatore del mouse su una variabile per visualizzare la descrizione dati, è possibile rendere trasparente il suggerimento dati per visualizzare il codice sottostante. Questa azione attiva anche la trasparenza per altre azioni tip nell'editor di codice, ad esempio definizioni di metodi e sintassi delle espressioni.
Per abilitare la trasparenza, seguire questa procedura:
Nell'editor di Visual Studio Code selezionare all'interno di una descrizione dati e quindi selezionare e tenere premuto CTRL.
Per mantenere la trasparenza, continuare a tenere premuto CTRL.
Per terminare la trasparenza, interrompere la selezione di CTRL o selezionare altrove.
La trasparenza non è disponibile per una mancia dati bloccata o mobile.
Mantieni espansi i suggerimenti per i dati
In Visual Studio 2022 Update 1 e versioni successive, quando si espande un suggerimento dati, è possibile mantenerlo espanso fino a quando non si seleziona altrove. Questa azione produce una mancia dati permanente .
Per rendere un suggerimento dati permanente, seguire questa procedura:
In Visual Studio selezionare Opzioni di debug>per aprire la finestra di dialogo Opzioni.
Nella scheda Generale scorrere per individuare l'opzione Mantieni i suggerimenti per i dati espansi aperta fino a quando non si fa clic sull'opzione.
Selezionare la casella di controllo per abilitare l'opzione sticky e selezionare OK.
Quando l'opzione sticky è abilitata, se si espande un suggerimento dati nell'editor di codice, rimane espansa.
Aggiungere suggerimenti per i dati
È possibile aggiungere un suggerimento per i dati per mantenerlo aperto nell'area dell'editor di codice. È anche possibile modificare la posizione del suggerimento dati aggiunto.
Per aggiungere un suggerimento per i dati, seguire questa procedura:
Nell'editor di Visual Studio Code passare il puntatore del mouse su una variabile per visualizzare la descrizione dati.
Nella descrizione dati usare la puntina per selezionare Aggiungi all'origine:
Visual Studio aggiunge il suggerimento dati a una posizione nelle vicinanze della variabile sulla superficie di codice. Nella barra dell'editor di codice accanto alla riga in cui si aggiunge la descrizione dati viene visualizzata una puntina.
Selezionare e trascinare il suggerimento per i dati aggiunti in qualsiasi posizione nell'area dell'editor di codice.
Suggerimenti per i dati Float (unpin)
Dopo aver aggiunto un suggerimento dati, è possibile rimuovere il suggerimento dati e renderlo float. Una descrizione dati mobile può essere posizionata ovunque nell'IDE di Visual Studio.
Per spostare un suggerimento dati, seguire questa procedura:
In un suggerimento per i dati aggiunti usare la puntina per selezionare Rimuovi dall'origine.
Visual Studio rimuove il suggerimento dati e fornisce alla descrizione dati uno sfondo a tinta unita. La puntina da disegno per il suggerimento dati viene modificata nella posizione non bloccata e la puntina nella barra dell'editor di codice viene rimossa.
Selezionare e trascinare la descrizione dati mobile in qualsiasi posizione nell'IDE di Visual Studio.
Se si posiziona la descrizione dati mobile all'esterno dell'area dell'editor di codice, la puntina da disegno viene rimossa dal menu laterale della descrizione dati. L'opzione Aggiungi all'origine è disponibile solo quando la descrizione dati mobile è posizionata nell'area dell'editor di codice.
Suggerimenti per il ripristino dei dati
Dopo aver spostato un suggerimento dati, è possibile ripristinarlo in una posizione di origine specifica nell'area dell'editor di codice.
Per rimuovere un suggerimento dati mobile, seguire questa procedura:
Selezionare e spostare la descrizione dati mobile e posizionarla nell'area dell'editor di codice.
Nella descrizione dati mobile usare la puntina per selezionare Aggiungi all'origine.
La puntina da disegno viene modificata nella posizione bloccata. Il suggerimento per i dati viene restituito a una posizione specifica nell'editor di codice e una puntina per l'origine viene visualizzata nella barra dell'editor di codice.
Chiudere i suggerimenti per i dati
È possibile chiudere i suggerimenti per i dati in Visual Studio in diversi modi.
Quando si termina la sessione di debug, se sono presenti suggerimenti per i dati aperti, Visual Studio li chiude. Se si avvia un'altra sessione di debug, Visual Studio tenta di ristabilire eventuali suggerimenti per i dati lasciati in precedenza aperti.
La tabella seguente riepiloga come chiudere manualmente i suggerimenti per i dati:
| Chiudi destinazione | Azione |
|---|---|
| Suggerimento specifico per i dati | Selezionare la X nella descrizione dati. |
| Tutti i suggerimenti per i dati per un file specifico | Selezionare Debug>Cancella tutti i suggerimenti dati aggiunti a <Nome file> sulla barra degli strumenti di Visual Studio. |
| Tutti i suggerimenti aperti per i dati | Selezionare Debug>Cancella tutti i suggerimenti dati sulla barra degli strumenti di Visual Studio. |
Usare variabili e valori nei suggerimenti per i dati
Quando si lavora con i suggerimenti dati in Visual Studio, è possibile visualizzare i dettagli relativi a variabili e oggetti e modificare i valori durante il debug. Queste funzionalità sono utili per la risoluzione dei problemi rapidi e i test delle modifiche apportate al codice.
Espandere gli oggetti nei suggerimenti dati per visualizzare i membri
Quando un suggerimento dati rappresenta una matrice, una struttura o un oggetto, è possibile espandere la visualizzazione descrizione dati per visualizzare i membri. La visualizzazione espansa mostra le informazioni aggiuntive in un formato albero gerarchico.
Per espandere la visualizzazione per un oggetto in un suggerimento dati, seguire questa procedura:
In una descrizione dati per una matrice, una struttura o un oggetto selezionare la freccia di espansione prima del nome dell'elemento per visualizzare i membri. La vista viene presentata in formato albero:
Per un suggerimento per i dati aggiunto, selezionare il simbolo più (+) prima del nome della variabile per espandere la definizione.
Continuare a selezionare le frecce di espansione per visualizzare altri elementi della gerarchia dei membri:
Per spostarsi verso l'alto e verso il basso nella visualizzazione espansa, usare i tasti freccia su e giù del mouse o della tastiera.
Per aggiungere un membro espanso con la descrizione dati aggiunta originale, usare la puntina a forma di puntina sul membro per selezionare Aggiungi all'origine. Dopo aver compresso la visualizzazione albero, tutti gli elementi membri aggiunti rimangono visibili con la descrizione dati aggiunta.
Modificare i valori delle variabili
Un altro vantaggio dell'uso dei suggerimenti dati è la possibilità di modificare il valore di una variabile o di un elemento in una descrizione dati durante il debug. Questa funzionalità è utile per il test rapido delle piccole modifiche apportate al codice.
Per modificare il valore di una variabile o di un elemento in un suggerimento dati, seguire questa procedura:
Nella descrizione dati selezionare il valore. Visual Studio evidenzia il valore e lo rende disponibile per la modifica.
Immettere un nuovo valore nella descrizione dati e selezionare Invio.
Tenere presente che alcuni valori delle variabili sono di sola lettura. Visual Studio non rende disponibili valori di sola lettura per la modifica.
Usare i commenti nei suggerimenti per i dati
L'area Commenti di un suggerimento dati è utile per tenere note sulle variabili durante il debug del codice. Questa area è una posizione comoda per tenere traccia di valori diversi man mano che cambiano durante il debug. È possibile aggiungere commenti in una mancia dati bloccata o mobile.
Per usare Commenti in un suggerimento dati, seguire questa procedura:
Nella descrizione dati usare la doppia freccia GIÙ per selezionare Espandi per visualizzare il commento. La freccia doppia verso il basso apre l'area Commenti della descrizione dati in cui è possibile aggiungere note.
Per aggiungere un commento, inserire il cursore nell'area Commenti e immettere testo. L'area accetta più righe.
Per chiudere l'area Commenti , usare la doppia freccia SU per comprimere i commenti. Tutti i commenti immessi rimangono con il suggerimento per i dati, ma non sono attualmente visibili.
Aggiungere proprietà nei suggerimenti per i dati
Visual Studio supporta l'aggiunta di proprietà nei suggerimenti per i dati aggiunti in .NET Core 3.0 e versioni successive. Questa funzionalità consente di esaminare rapidamente gli oggetti in base alle relative proprietà nei suggerimenti per i dati.
Per aggiungere le proprietà nei suggerimenti per i dati, seguire questa procedura:
In un suggerimento dati aggiunto espandere la gerarchia dei membri finché non viene visualizzata una proprietà che si vuole mantenere visibile con la descrizione dati.
Usare la puntina per la proprietà per aggiungerla con la descrizione dati. È anche possibile fare clic con il pulsante destro del mouse sulla proprietà e scegliere Aggiungi membro come preferito.
Visual Studio sposta la proprietà selezionata all'inizio dell'elenco delle proprietà dell'oggetto. Il nome e il valore della proprietà vengono visualizzati nella colonna destra della descrizione dati aggiunta:
Per rimuovere una proprietà in un suggerimento dati, selezionare di nuovo la puntina da disegno per la proprietà oppure fare clic con il pulsante destro del mouse sulla proprietà e selezionare Rimuovi membro come preferito.
È anche possibile attivare o disattivare la visibilità dei nomi delle proprietà e filtrare le proprietà non rimosse nell'elenco delle proprietà dell'oggetto in un suggerimento dati:
Per filtrare le proprietà non bloccate, fare clic con il pulsante destro del mouse sulla riga della proprietà nella descrizione dati e selezionare Mostra solo membri aggiunti.
Per attivare o disattivare la visibilità dei nomi delle proprietà, fare clic con il pulsante destro del mouse sulla riga della proprietà nella descrizione dati e scegliere Nascondi nomi membri aggiunti in Valori.
L'immagine seguente mostra le varie opzioni nel menu di scelta rapida per la gerarchia dei membri in una descrizione dati:
Ottenere assistenza per l'intelligenza artificiale
Se si ha Copilot, è possibile ottenere assistenza per l'intelligenza artificiale durante l'analisi delle variabili nei suggerimenti per i dati. Fare clic con il pulsante destro del mouse su una variabile e usare il pulsante Ask Copilot
. In questo scenario Copilot conosce già il contesto per la domanda, quindi non è necessario fornire il contesto in chat. Per altre informazioni, vedere Debug con Copilot.
Visualizzare i tipi di dati complessi
I visualizzatori visualizzano informazioni in modo più significativo e talvolta grafico. Esempi di visualizzatori includono XML, HTML, JSON e visualizzatore di testo. È possibile usare le visualizzazioni per esaminare i tipi di dati complessi nel codice durante il debug.
Se i visualizzatori sono disponibili per un elemento, Visual Studio visualizza la lente di ingrandimento View accanto al nome dell'elemento nella descrizione dati. Quando si seleziona una visualizzazione, Visual Studio apre una finestra separata per visualizzare i dati complessi in un formato leggibile.
È possibile usare questa funzionalità per selezionare una visualizzazione per i dati:
Per visualizzare l'elemento usando il visualizzatore predefinito per il tipo di dati, selezionare la lente di ingrandimento.
Per selezionare un visualizzatore specifico, espandere l'elenco a discesa Visualizza accanto alla lente di ingrandimento e scegliere un'opzione.
Aggiungere variabili alle finestre Espressioni di controllo
È possibile continuare a controllare le variabili aggiungendole a una finestra Espressione di controllo di Visual Studio da una descrizione dati:
- Nella descrizione dati fare clic con il pulsante destro del mouse sul nome della variabile e scegliere Aggiungi espressione di controllo.
Visual Studio aggiunge la variabile nella finestra Espressione di controllo . Se l'edizione di Visual Studio supporta più finestre Espressioni di controllo , la variabile viene visualizzata nella finestra con l'etichetta Espressione di controllo 1.
Importare ed esportare suggerimenti per i dati
È possibile esportare suggerimenti per i dati in un file XML, che è possibile condividere o modificare usando un editor di testo. È anche possibile importare suggerimenti per i dati da un file XML ricevuto o modificato in precedenza.
Per esportare i suggerimenti per i dati, seguire questa procedura:
In Visual Studio selezionare Debug Export DataTips (Debug>Export DataTips). Verrà visualizzata la finestra di dialogo Esporta descrizioni dati.
Nella finestra di dialogo passare al percorso in cui si desidera salvare il file XML.
Immettere un nome per il file di esportazione e selezionare Salva.
Visual Studio esporta i suggerimenti per i dati nel file e nel percorso specificati.
Per importare suggerimenti per i dati da un file, seguire questa procedura:
In Visual Studio selezionare Debug Import DataTips (Debug>Import DataTips). Verrà visualizzata la finestra di dialogo Importa descrizioni dati.
Nella finestra di dialogo passare al percorso del file XML dei suggerimenti dati da usare per l'importazione.
Selezionare il file da aprire e selezionare Apri.
Visual Studio importa i suggerimenti per i dati dal file specificato nell'area di lavoro corrente. Quando si esegue il debug del codice dell'area di lavoro, sono disponibili i suggerimenti per i dati importati.