Condividi tramite

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

  • Articolo

È 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 selezionare 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 profili di avvio 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 Start external program.
directory di lavoro Specifica la directory di lavoro dell'app sottoposta a debug. In C# la directory di lavoro è \bin\debug per impostazione predefinita.
Usare il computer remoto Per il debug remoto, selezionare questa opzione e immettere il nome della destinazione per il debug remoto oppure 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 condivisa nel computer remoto.
variabili di ambiente Imposta le variabili di ambiente prima di eseguire il processo dell'applicazione. Per ASP.NET Core, vedere ambienti .
Abilitare il debug di codice non gestito Esegue il debug delle chiamate al codice Win32 non gestito (nativo) a partire dall'applicazione gestita.
Abilitare il debug di 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 un'interfaccia utente semplice per il file di launchSettings.json del progetto. Per altre informazioni su questo file, vedere la sezione Sviluppo e launchSettings.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 quando si avvia il debug, usando l'URL impostato nell'impostazione URL.
url Specifica il percorso dell'URL host per .NET o .NET Core. Per un profilo denominato come il progetto (ovvero, la proprietà commandName in launchSettings.json è Project), il server Kestrel ascolta la porta specificata. Per un profilo IIS, il valore è generalmente uguale a quello dell'URL dell'app . Per ulteriori informazioni, consultare la sezione relativa al 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 launchSettings.json. Questi due tipi di profilo forniscono diverse impostazioni, ad esempio il modello di hosting.

Impostazione Descrizione
modello di hosting Selezionare "In Processo" (impostazione predefinita) o "Fuori dal Processo". Per altre informazioni, vedere Modelli di hosting nella documentazione di ASP.NET Core.
URL SSL dell'app Per IIS Express, la URL SSL dell'app è in genere

Scheda Compila

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

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

Queste costanti consentono la compilazione condizionale della classe Debug e della classe Trace. Con queste costanti definite, i metodi delle classi Debug e Trace generano l'output nella finestra di Output . Senza queste costanti, i metodi della classe Debug e Trace non vengono compilati e non viene 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.
> Ottimizzazione del codice A meno che non venga visualizzato un bug solo nel codice ottimizzato, lasciare deselezionata questa impostazione per le build 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 Semplificare il debug di un'immagine.
Percorso di output base> 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 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.

  • Nessun simbolo viene emesso

    Specifica che non verranno generate informazioni di debug.

  • file PDB della piattaforma corrente

    Producono un file .PDB, un file di simboli specifico della piattaforma che fornisce informazioni ad altri strumenti, in particolare ai debugger, sul contenuto del file eseguibile principale e sulla sua modalità di produzione.

  • file PDB portabile,

    Producono un file .PDB, un file di simboli non specifico della piattaforma e portabile che fornisce ad altri strumenti, in particolare ai debugger, informazioni su ciò che si trova nel file eseguibile principale e su come è stato prodotto. Per altre informazioni, vedere PDB portabile .

  • Incorporato in DLL/EXE, portabile tra piattaforme

    Incorpora le informazioni sui simboli portabili nell'assembly. Non viene prodotto alcun file .PDB esterno.

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

Vedere anche