Impostazioni del progetto per le configurazioni di debug C# (.NET Core, .NET 5+e ASP.NET Core)

È possibile modificare le impostazioni di debug del progetto C# nella scheda Debug e nella scheda Compila delle pagine delle proprietà del progetto.

Per aprire le pagine delle proprietà, selezionare il progetto in Esplora soluzioni e quindi selezionare l'icona Proprietà oppure fare clic con il pulsante destro del mouse sul progetto e scegliere Proprietà.

Per altre informazioni, vedere Configurazioni di debug e rilascio.

Importante

Queste impostazioni non si applicano alle app .NET Framework o UWP. Per configurare le impostazioni di debug per .NET Framework, vedere Impostazioni del progetto per le configurazioni di debug C#.

Scheda Debug

A partire da Visual Studio 2022, scegliere Apri interfaccia utente dei profili di avvio del debug nella scheda Debug per aprire l'interfaccia utente dei profili di avvio e modificare le impostazioni di debug.

Profilo di avvio (.NET Core, .NET 5+)

Impostazione Descrizione
Argomenti della riga di comando Specifica gli argomenti della riga di comando per l'app sottoposta a debug. Il nome del comando è il nome dell'app specificato in Avvia programma esterno.
Directory di lavoro Specifica la directory di lavoro dell'app sottoposta a debug. In C# la directory di lavoro è \bin\debug per impostazione predefinita.
Usa computer remoto Per il debug remoto, selezionare questa opzione e immettere il nome della destinazione di debug remoto o un nome del server Msvsmon.
Il percorso di un'app nel computer remoto viene specificato dalla proprietà Percorso di output nella scheda Compilazione . Il percorso deve essere una directory condivisibile nel computer remoto.
Variabili di ambiente Imposta le variabili di ambiente prima di eseguire il processo dell'applicazione. Per ASP.NET Core, vedere Ambienti.
Abilita debug codice non gestito Esegue il debug delle chiamate al codice Win32 nativo (non gestito) dall'app gestita.
Abilita debug SQL Server Esegue il debug di oggetti di database di SQL Server.
Abilitare il debug di WebView2 Esegue il debug di JavaScript con il debugger basato su Microsoft Edge (Chromium).

Profilo di avvio (ASP.NET Core)

Oltre alle proprietà per .NET 5+, i profili di avvio di ASP.NET Core includono diverse proprietà aggiuntive per i diversi profili ASP.NET Core. Queste impostazioni forniscono una semplice interfaccia utente per il file launch Impostazioni.json del progetto. Per altre informazioni su questo file, vedere la sezione Sviluppo e avvio Impostazioni.json in Usare più ambienti in ASP.NET Core.

Le impostazioni fornite nell'interfaccia utente dei profili di avvio includono quanto segue.

Impostazione Descrizione
Avviare il browser Selezionare se avviare il browser predefinito all'avvio del debug, usando l'URL impostato nell'impostazione URL .
Url Specifica il percorso dell'URL host per .NET o .NET Core. Per un profilo denominato dopo il progetto( ovvero la proprietà commandName in launch Impostazioni.json è Project), il server Kestrel rimane in ascolto della porta specificata. Per un profilo IIS, si tratta in genere dello stesso valore dell'URL dell'app. Per altre informazioni, vedere la sezione profilo di avvio di IIS in Configurare il progetto.
URL dell'app Specifica gli URL dell'applicazione. Per un profilo denominato dopo il progetto, questa proprietà specifica gli URL del server Kestrel, in genere https://localhost:5001 e http://localhost:5000

Visual Studio fornisce un profilo IIS Express per impostazione predefinita ed è possibile creare profili aggiuntivi, ad esempio un profilo IIS. Queste impostazioni corrispondono anche alle impostazioni in launch Impostazioni.json. Questi due tipi di profilo forniscono diverse impostazioni, ad esempio il modello di hosting.

Impostazione Descrizione
Modello di hosting Specificare In Processo (impostazione predefinita) o Out of Process (Out of Process). Per altre informazioni, vedere Hosting di modelli nella documentazione di ASP.NET Core.
URL SSL dell'app Per IIS Express, l'URL SSL dell'app è in generehttp://localhost:44334.

Scheda Crea

La tabella seguente illustra le impostazioni di compilazione utili per il debug. Per una spiegazione completa delle impostazioni di compilazione, vedere Pagina compilazione, Progettazione progetti.

Impostazione Descrizione
Simboli di compilazione condizionale generali> Definire le costanti DEBUG e TRACE, se selezionate.

Esse attivano la compilazione condizionale della Classe Debug e della Classe Trace. Quando sono definite, i metodi delle classi Debug e Trace generano l'output per la finestra di output. In caso contrario, tali metodi non verranno compilati e non verrà generato alcun output.

In genere, DEBUG è definito nella versione debug di una build e non definita nella versione release. TRACE è definito sia nelle versioni di debug che di rilascio.
Codice di ottimizzazione generale> A meno che non venga visualizzato un bug solo nel codice ottimizzato, lasciare deselezionata questa impostazione per Le compilazioni di debug. Il codice ottimizzato è più difficile da eseguire per il debug, perché le istruzioni non corrispondono direttamente alle istruzioni nel codice sorgente.
Simboli di debug Specifica il tipo di informazioni di debug generate dal compilatore. Vedere Simboli di debug. Per informazioni su come configurare le prestazioni di debug di un'applicazione, vedere Semplificazione del debug di un'immagine.
Percorso>di output di base di output Specifica la cartella di base per l'output intermedio. L'output in genere passa a bin\Debug per una compilazione di debug.
Percorso di>output intermedio di base di output Specifica la cartella di base per l'output intermedio. L'output in genere passa a obj\Debug per una compilazione di debug.

Simboli di debug

È possibile scegliere le opzioni seguenti per i simboli di debug.

  • Non vengono generati simboli

    Specifica che non saranno generate informazioni di debug.

  • File PDB, piattaforma corrente

    Produce un oggetto . File PDB, un file di simboli specifico della piattaforma che fornisce altri strumenti, in particolare debugger, informazioni su ciò che si trova nel file eseguibile principale e su come è stato prodotto.

  • File PDB, portabile

    Crea un file con estensione pdb, vale a dire un file di simboli di tipo PE non specifico per la piattaforma che offre altri strumenti, soprattutto debugger, informazioni su cosa contiene il file eseguibile principale e come è stato generato. Vedere Portable PDB (PDB portatile) per altre informazioni.

  • Incorporato in DLL/EXE, portabile su più piattaforme

    Incorpora informazioni sui simboli di tipo PE nell'assembly. Non vengono generati file con estensione pdb esterni.

Per altre informazioni, vedere /debug (Opzioni del compilatore C#).

Vedi anche