Funzionalità di IntelliTrace (C#, Visual Basic, C++)

Articolo
03/10/2023

È possibile utilizzare IntelliTrace per registrare gli eventi e il metodo chiama l'applicazione, che consente di esaminare il relativo stato (stack di chiamate e i valori delle variabili locali) in diversi momenti dell'esecuzione. È sufficiente avviare il debug come di consueto: IntelliTrace è attivato per impostazione predefinita ed è possibile visualizzare le informazioni registrate in IntelliTrace nella nuova finestra Strumenti di diagnostica nella scheda Eventi . Selezionare un evento e fare clic su Attiva debug cronologico per visualizzare lo stack di chiamate e le variabili locali registrate per questo evento.

Per una descrizione dettagliata, vedere procedura dettagliata: Uso di IntelliTrace.

È possibile utilizzare IntelliTrace in Visual Studio Enterprise edition ma non le edizioni Professional o Community.

Per verificare che IntelliTrace sia attivato, aprire la pagina Opzioni strumenti >> IntelliTrace . Abilita IntelliTrace deve essere selezionata per impostazione predefinita.

Nota

L'ambito di tutte le impostazioni nella pagina delle opzioni di IntelliTrace è Visual Studio nel suo insieme, non i singoli progetti o le singole soluzioni. Una modifica di queste impostazioni si applica a tutte le istanze di Visual Studio, le sessioni di debug tutti e tutti i progetti o soluzioni.

Scegliere gli eventi registrati da IntelliTrace (C#, Visual Basic)

È possibile attivare o disattivare la registrazione di eventi di IntelliTrace specifici.

Se il debug è in corso, interromperlo. Passare a Strumenti > Opzioni > IntelliTrace IntelliTrace > Eventi. Scegliere gli eventi di IntelliTrace per registrare.

Raccogliere snapshot (C#, Visual Basic, C++)

Questa opzione non è abilitata per impostazione predefinita, ma IntelliTrace può acquisire snapshot dell'applicazione in ogni punto di interruzione e evento del passaggio del debugger ed è possibile visualizzare questi snapshot in una sessione di debug cronologica. Uno snapshot offre una visualizzazione dello stato completo dell'applicazione. Per abilitare l'acquisizione di snapshot, passare a Strumenti Opzioni IntelliTrace Generale e selezionare Snapshot IntelliTrace (gestiti e nativi).To enable the capture of snapshots, go to Tools Options IntelliTrace > General, and select IntelliTrace snapshots (managed and native).>> Per altre informazioni, vedere Visualizzare lo stato precedente dell'applicazione con IntelliTrace.

Gli snapshot sono disponibili in Visual Studio Enterprise 2017 versione 15.5 e successive e richiede l'aggiornamento dell'anniversario di Windows 10 o versione successiva. Per le app .NET Core e ASP.NET Core, è necessario Visual Studio Enterprise 2017 versione 15.7. Per le app native destinate a Windows, è necessario Visual Studio Enterprise 2017 versione 15.9 Preview 2.

Raccogliere eventi IntelliTrace e informazioni sulle chiamate (C#, Visual Basic)

Questo non è abilitato per impostazione predefinita, ma IntelliTrace è in grado di registrare le chiamate ai metodi insieme agli eventi. Per abilitare la raccolta di chiamate al metodo, passare a Strumenti Opzioni IntelliTrace Generale e selezionare Eventi IntelliTrace e informazioni sulle chiamate (solo gestite).To enable collection of method calls go to Tools Options IntelliTrace > General, and select IntelliTrace events and call information (managed only).>>

Le informazioni sulle chiamate non sono attualmente disponibili per le app .NET Core e ASP.NET Core.

In tal modo è possibile visualizzare la cronologia dello stack di chiamate e scorrere in avanti e indietro le chiamate nel codice. IntelliTrace registra i dati, ad esempio nomi delle funzioni, punti di ingresso e uscita delle funzioni e alcuni valori di parametri e valori restituiti.

Suggerimento

Questa opzione non è abilitata per impostazione predefinita in quanto tale operazione comporta un notevole sovraccarico. Non solo ha IntelliTrace intercettare ogni chiamata al metodo che rende l'applicazione, ma dispone anche di gestire un set di dati molto maggiore se si desidera visualizzare su schermo o renderli persistenti su disco.

È possibile ridurre l'overhead delle prestazioni limitando l'elenco degli eventi che registra IntelliTrace e mantenendo il numero di moduli si raccolgono al minimo. Per altre informazioni, vedere Controllare quante informazioni di chiamata vengono registrate da IntelliTrace.

È possibile utilizzare la barra di navigazione viene visualizzato a sinistra della finestra del codice. Se la barra di spostamento non viene visualizzata, passare a Strumenti Opzioni IntelliTrace Avanzate e selezionare >Visualizza la barra di spostamento in modalità di debug.>>

La barra di navigazione consente di spostarsi avanti e indietro tra chiamate ai metodi e gli eventi in modalità di debug cronologico. Per altre informazioni sul debug cronologico, vedere Debug cronologico. Dispone di una serie di comandi:

Comando	Descrizione
Imposta contesto debugger	Consente di impostare il contesto di debug sull'intervallo di tempo della chiamata dove viene visualizzato. Questa icona compare solo sullo stack di chiamate corrente.
Torna al sito di chiamata	Spostare il puntatore e il contesto di debug indietro nel momento in cui è stata chiamata la funzione corrente. Se si è in modalità debug attivo, questo comando attiva il debug cronologico. Se si passa nuovamente all'interruzione dell'esecuzione originale, il debug cronologico è disattivato e Live debug è attivato.
Passa a chiamata o a evento IntelliTrace precedente	Spostare il puntatore e il contesto di debug indietro nel tempo all'evento o alla chiamata precedente. Se si è in modalità debug attivo, questo comando attiva il debug cronologico.
Entra	Passaggio alla funzione attualmente selezionato. Questo comando è disponibile solo quando si esegue il debug con IntelliTrace.
Passa a chiamata o a evento IntelliTrace successivo	Spostare il puntatore e il contesto di debug avanti nel tempo nella chiamata o nell’evento successivo per cui esistono dati IntelliTrace. Questo comando è disponibile solo quando si esegue il debug con IntelliTrace.
Passa alla modalità attiva	Torna alla modalità debug attivo

Cerca una riga o metodo in IntelliTrace

È possibile cercare i metodi solo quando è state abilitate informazioni sulla chiamata di metodo. È possibile cercare la cronologia di IntelliTrace per un metodo o una riga specifica. Durante l'esecuzione del debugger viene interrotto, fare clic con il pulsante destro del mouse all'interno del corpo della funzione per visualizzare il menu di scelta rapida e fare clic su Cerca questa riga in IntelliTrace o Cerca questo metodo in IntelliTrace.

Controllare la quantità di informazioni sulle chiamate record IntelliTrace

Per impostazione predefinita IntelliTrace registra le informazioni per tutti i moduli utilizzati nella soluzione. È possibile disporre delle registrazioni delle informazioni sulle chiamate di IntelliTrace solo per i moduli di interesse. In Strumenti > Opzioni > Moduli IntelliTrace > è possibile specificare i moduli da includere o i moduli da escludere da IntelliTrace. IntelliTrace verrà raccolti solo gli eventi originati da moduli che è stato specificato e le chiamate al metodo che si sono verificati all'interno di moduli che si è interessati.

Per aggiungere più moduli, utilizzare il carattere jolly * all'inizio o alla fine della stringa. Per i nomi dei moduli, utilizzare nomi di file e non nomi di assembly. I percorsi file non sono accettati.

Provare a ridurre al minimo il numero di moduli. È possibile ottenere prestazioni migliori perché non ci sono meno dati da raccogliere. Si ottiene anche meno rumore nell'interfaccia utente perché non ci sono meno dati passino attraverso.

Salvare i dati IntelliTrace nel file (C#, Visual Basic, C++)

È possibile salvare i dati raccolti da IntelliTrace in Debug > IntelliTrace Save IntelliTrace Session durante il debug e l'applicazione si trova in uno stato di interruzione>. La voce di menu è disabilitata e non sarà in grado di salvare i dati che raccolti da IntelliTrace se l'applicazione è ancora in esecuzione o se si interrompe il debug.

È possibile configurare IntelliTrace per salvare automaticamente in un file passando a Strumenti > Opzioni > IntelliTrace > Avanzate e selezionando Archivia registrazioni IntelliTrace in questa directory. È inoltre possibile configurare una dimensione fissa per il file generato, provocando IntelliTrace per sovrascrivere i dati meno recenti quando si esaurisce lo spazio. Visual Studio crea due file per ogni sessione di IntelliTrace quando vengono salvati automaticamente e il processo di hosting di Visual Studio (vshost.exe) è attivato.

Suggerimento

Per risparmiare spazio su disco, disattivare il salvataggio dei file automaticamente quando non sono più necessari. Tutti i file esistenti non verranno eliminati. È sempre possibile salvare il file su richiesta dal menu di scelta rapida.

Quando si salvano i dati di IntelliTrace per file, è possibile ottenere un file con estensione iTrace per ogni processo IntelliTrace raccolti da. È quindi possibile aprire il file .itrace in Visual Studio passando a File > Apri > file e selezionando il file con estensione itrace dalla finestra di dialogo Apri file. Per altre informazioni, vedere Uso dei dati di IntelliTrace salvati.