Share via


Visualizzare i valori dei dati in Data Suggerimenti nell'editor di codice

I suggerimenti per i dati offrono un modo pratico per visualizzare informazioni sulle variabili nel programma durante il debug. I suggerimenti per i dati funzionano solo in modalità di interruzione e solo con variabili che rientrano nell'ambito corrente dell'esecuzione. Se questa è la prima volta che si è tentato di eseguire il debug del codice, è possibile leggere Debug per principianti e tecniche e strumenti di debug assoluti prima di eseguire questo articolo.

Usare i suggerimenti per i dati

I suggerimenti per i dati vengono visualizzati solo in modalità di interruzione e solo sulle variabili che si trovano nell'ambito corrente dell'esecuzione.

Visualizzare un suggerimento per i dati

  1. Impostare un punto di interruzione nel codice e avviare il debug premendo F5 o selezionando Debug>Avvia debug.

  2. Quando viene sospesa in corrispondenza del punto di interruzione, passare il puntatore del mouse su qualsiasi variabile nell'ambito corrente. Viene visualizzata una descrizione dati che mostra il nome e il valore corrente della variabile.

Rendere trasparente un suggerimento per i dati

Per rendere trasparente un suggerimento dati per visualizzare il codice sottostante, mentre nella descrizione dati premere CTRL. Il suggerimento per i dati rimane trasparente finché si tiene premuto CTRL. Questa operazione non funziona per i suggerimenti per i dati aggiunti o mobili.

Mantenere un suggerimento per i dati espanso

A partire da Visual Studio 2022 Update 1, quando si espande un suggerimento dati, è possibile mantenerlo espanso fino a quando non si fa clic altrove. Si tratta di una descrizione dati permanente. Per abilitare questa funzionalità, selezionare Strumenti>Opzioni>debug e quindi nella scheda Generale selezionare Mantieni i suggerimenti per i dati espansi aperti fino a quando non si fa clic.

Aggiungere un suggerimento per i dati

Per aggiungere un suggerimento dati in modo che rimanga aperto, selezionare l'icona Aggiungi all'origine .

Pin a data tip

È possibile spostare una descrizione dati bloccata trascinandola nella finestra del codice. Viene visualizzata un'icona a forma di puntina accanto alla riga a cui viene aggiunta la descrizione dati.

Nota

I suggerimenti dati vengono sempre valutati nel contesto in cui l'esecuzione viene sospesa, non nel cursore corrente o nel percorso della mancia 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, viene visualizzato il valore della variabile nel contesto corrente.

Rimuovere un suggerimento per i dati dall'origine

Per spostare una descrizione dati bloccata, passare il puntatore sul suggerimento dati e selezionare l'icona della puntina da disegno dal menu di scelta rapida.

L'icona della puntina a forma di puntina viene modificata nella posizione non bloccata e il suggerimento dati ora galleggia o può essere trascinato sopra tutte le finestre aperte. I suggerimenti per i dati mobili si chiudono al termine della sessione di debug.

Rimuovere un suggerimento per i dati

Per ripristinare un suggerimento dati mobile all'origine, passare il puntatore del mouse sull'editor di codice e selezionare l'icona della puntina da disegno. L'icona della puntina a forma di puntina viene modificata nella posizione bloccata e il suggerimento dati viene nuovamente aggiunto solo alla finestra del codice.

Se un suggerimento dati viene spostato su una finestra del codice non sorgente, l'icona della puntina da disegno non è disponibile e il suggerimento dati non può essere repinned. Per accedere all'icona della puntina da disegno, restituire il suggerimento dati alla finestra dell'editor di codice trascinandolo o assegnando lo stato attivo alla finestra del codice.

Chiudere un suggerimento per i dati

Per chiudere una descrizione dati, passare il puntatore del mouse sul suggerimento dati e selezionare l'icona chiudi (x) dal menu di scelta rapida.

Chiudere tutti i suggerimenti per i dati

Per chiudere tutti i suggerimenti per i dati, scegliere Cancella tutti i suggerimenti dati dal menu Debug.

Chiudere tutti i suggerimenti per i dati per un file specifico

Per chiudere tutti i suggerimenti per i dati per un file specifico, scegliere Cancella tutti i suggerimenti dati Aggiunti a <Nome file> dal menu Debug.

Espandere e modificare le informazioni

È possibile usare i suggerimenti per i dati per espandere una matrice, una struttura o un oggetto per visualizzarne i membri. È anche possibile modificare il valore di una variabile da un suggerimento dati.

Espandere una variabile

Per espandere un oggetto in una descrizione dati per visualizzarne gli elementi, passare il puntatore del mouse sulle frecce di espansione prima dei nomi degli elementi per visualizzare gli elementi nella maschera ad albero. Per un suggerimento per i dati aggiunti, selezionare + prima del nome della variabile e quindi espandere l'albero.

Expand a data tip

È possibile usare il mouse o i tasti di direzione sulla tastiera per spostarsi verso l'alto e verso il basso nella visualizzazione espansa.

È anche possibile aggiungere elementi espansi alla descrizione dati aggiunta passando il puntatore del mouse su di essi e selezionando le icone della puntina da disegno. Gli elementi vengono quindi visualizzati nella descrizione dati aggiunta dopo che l'albero è compresso.

Modificare il valore di una variabile

Per modificare il valore di una variabile o di un elemento in una descrizione dati, selezionare il valore, digitare un nuovo valore e premere INVIO. La selezione è disabilitata per i valori di sola lettura.

Aggiungere proprietà nei suggerimenti per i dati

Nota

Questa funzionalità è supportata per .NET Core 3.0 o versione successiva.

È possibile esaminare rapidamente gli oggetti in base alle relative proprietà nei suggerimenti per i dati con lo strumento Proprietà associabili. Per usare questo strumento, passare il puntatore del mouse su una proprietà e selezionare l'icona a forma di puntina visualizzata o fare clic con il pulsante destro del mouse e selezionare l'opzione Aggiungi membro come preferito nel menu di scelta rapida risultante. Questa proprietà viene visualizzata all'inizio dell'elenco delle proprietà dell'oggetto e il nome e il valore della proprietà vengono visualizzati nella colonna destra della descrizione dati. Per rimuovere una proprietà, selezionare di nuovo l'icona a forma di puntina o selezionare l'opzione Rimuovi membro come preferito nel menu di scelta rapida .

Pinning a property in a data tip

È anche possibile attivare o disattivare i nomi delle proprietà e filtrare le proprietà non aggiunte quando si visualizza l'elenco delle proprietà dell'oggetto in un suggerimento dati. È possibile accedere a una delle opzioni facendo clic con il pulsante destro del mouse su una riga contenente una proprietà e scegliendo Mostra solo membri aggiunti o Nascondi nomi di membri aggiunti nelle opzioni dei valori nel menu di scelta rapida.

Visualizzare i tipi di dati complessi

Un'icona a forma di lente di ingrandimento accanto a una variabile o a un elemento in una descrizione dati indica che uno o più visualizzatori, ad esempio il visualizzatore di testo, sono disponibili per la variabile. I visualizzatori visualizzano informazioni in modo più significativo, talvolta grafico.

Per visualizzare l'elemento usando il visualizzatore predefinito per il tipo di dati, selezionare l'icona Visualizer icondella lente di ingrandimento . Selezionare la freccia accanto all'icona della lente di ingrandimento per selezionare da un elenco di visualizzatori per il tipo di dati.

Aggiungere una variabile a una finestra Espressione di controllo

Se si desidera continuare a controllare una variabile, è possibile aggiungerla a una finestra Espressione di controllo da un suggerimento dati. Fare clic con il pulsante destro del mouse sulla variabile nella descrizione dati e scegliere Aggiungi espressione di controllo.

La variabile viene visualizzata nella finestra Espressione di controllo . Se l'edizione di Visual Studio supporta più finestre Espressione di controllo, la variabile viene visualizzata in 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 un file XML di suggerimento dati ricevuto o modificato.

Per esportare i suggerimenti per i dati:

  1. Selezionare Debug>Esporta dati Suggerimenti.

  2. Nella finestra di dialogo Esporta dati Suggerimenti passare al percorso per salvare il file XML, digitare un nome per il file e quindi selezionare Salva.

Per importare suggerimenti per i dati:

  1. Selezionare Debug>Importa dati Suggerimenti.

  2. Nella finestra di dialogo Importa suggerimenti dati selezionare il file XML dei suggerimenti dati che si desidera aprire e quindi selezionare Apri.