Debug remoto di un progetto C# o Visual Basic in Visual Studio

Per eseguire il debug di un'applicazione di Visual Studio distribuita in un computer diverso, installare ed eseguire gli strumenti remoti nel computer in cui è stata distribuita l'app, configurare il progetto per connettersi al computer remoto da Visual Studio e quindi eseguire l'app.

Per informazioni sul debug remoto delle app UWP (Universal Windows Apps), vedere Eseguire il debug di un pacchetto di app installato.

Requisiti

Il debugger remoto è supportato in Windows 7 e versioni successive e nelle versioni di Windows Server a partire da Windows Server 2008 Service Pack 2. Per un elenco completo dei requisiti, vedere requisiti .

Nota

Il debug tra due computer connessi tramite un proxy non è supportato. Il debug via una connessione ad alta latenza o a bassa larghezza di banda, come una connessione Internet via modem o attraverso Internet tra paesi o regioni, non è consigliato e potrebbe fallire o essere inaccettabilmente lento.

Scaricare e installare gli strumenti remoti

Nel dispositivo remoto o nel server in cui si vuole eseguire il debug, anziché nel computer di Visual Studio, scaricare e installare la versione corretta degli strumenti remoti dai collegamenti nella tabella seguente.

• Scaricare l'aggiornamento più recente degli strumenti remoti per la versione di Visual Studio. Le versioni precedenti degli strumenti remoti non sono compatibili con le versioni successive di Visual Studio. Ad esempio, se si usa Visual Studio 2019, scaricare l'aggiornamento più recente degli strumenti remoti per Visual Studio 2019. In questo scenario non scaricare gli strumenti remoti per Visual Studio 2022.
• Scaricare gli strumenti remoti con la stessa architettura del computer in cui si stanno installando. Ad esempio, se si vuole eseguire il debug di applicazioni x86 in un computer remoto che esegue un sistema operativo x64, installare gli strumenti remoti x64. Per eseguire il debug di applicazioni x86, ARM o x64 in un sistema operativo ARM64, installare gli strumenti remoti ARM64.

Versione	Collegamento	Note
Visual Studio 2022	Strumenti remoti	Compatibile con tutte le versioni di Visual Studio 2022. Scaricare la versione corrispondente al sistema operativo del dispositivo (x86, x64 (AMD64) o ARM64. Nelle versioni precedenti di Windows Server, consulta la sezione Sblocca il download dei file per assistenza con il download degli strumenti remoti.
Visual Studio 2019	Strumenti remoti	Gli strumenti remoti per Visual Studio 2019 sono disponibili da My.VisualStudio.com. Se richiesto, partecipare al programma gratuito di Visual Studio Dev Essentials oppure accedere con l'ID sottoscrizione di Visual Studio. Scaricare la versione corrispondente al sistema operativo del dispositivo (x86, x64 (AMD64) o ARM64. Nelle versioni precedenti di Windows Server, consulta la sezione Sblocca il download dei file per assistenza con il download degli strumenti remoti.
Visual Studio 2017	Strumenti remoti	Gli strumenti remoti per Visual Studio 2017 sono disponibili da My.VisualStudio.com. Se richiesto, partecipare al programma gratuito di Visual Studio Dev Essentials oppure accedere con l'ID sottoscrizione di Visual Studio. Scaricare la versione corrispondente al sistema operativo del dispositivo (x86, x64 (AMD64) o ARM64. In Windows Server, vedi Sbloccare il download del file per informazioni sul download degli strumenti remoti.
Visual Studio 2015	Strumenti remoti	Gli strumenti remoti per Visual Studio 2015 sono disponibili da My.VisualStudio.com. Se richiesto, partecipare al programma gratuito di Visual Studio Dev Essentials oppure accedere con l'ID sottoscrizione di Visual Studio. In Windows Server, vedi Sbloccare il download del file per informazioni sul download degli strumenti remoti.
Visual Studio 2013	Strumenti remoti	Pagina di download nella documentazione di Visual Studio 2013
Visual Studio 2012	Strumenti remoti	Pagina di download nella documentazione di Visual Studio 2012

È possibile eseguire il debugger remoto copiando msvsmon.exe nel computer remoto, anziché installando gli strumenti remoti. Tuttavia, la Configurazione guidata del debugger remoto (rdbgwiz.exe) è disponibile solo quando si installano gli strumenti remoti. Potrebbe essere necessario usare la procedura guidata per la configurazione se si vuole eseguire il debugger remoto come servizio. Per altre informazioni, vedere (facoltativo) Configurare il debugger remoto come servizio.

Nota

• Per eseguire il debug di app di Windows 10 o versioni successive nei dispositivi ARM, usare ARM64, disponibile con la versione più recente degli strumenti remoti.
• Per eseguire il debug delle app di Windows 10 nei dispositivi Windows RT, usare ARM, disponibile solo nel download degli strumenti remoti di Visual Studio 2015.
• Per eseguire il debug di app x64 in un sistema operativo ARM64, eseguire il msvsmon.exe x64 installato con gli strumenti remoti ARM64.

Mancia

In alcuni scenari, può essere più efficiente eseguire il debugger remoto da una condivisione file. Per altre informazioni, vedere Eseguire il debugger remoto da una condivisione di file.

Configurare il debugger remoto

1. Sul computer remoto, individuare e avviare il debugger remoto dal menu Start .

   Se non si dispone delle autorizzazioni amministrative sul computer remoto, fare clic con il pulsante destro del mouse sull'app Debugger remoto e selezionare Esegui come amministratore. In caso contrario, inizialo normalmente.

   Se si prevede di connettersi a un processo in esecuzione come amministratore o in esecuzione con un account utente diverso, ad esempio IIS, fare clic con il pulsante destro del mouse sull'app Debugger remoto e selezionare Esegui come amministratore. Per ulteriori informazioni, consulta Esegui il debugger remoto come amministratore.

2. La prima volta che si avvia il debugger remoto (o prima di averla configurata), viene visualizzata la configurazione di debug remoto procedura guidata.

   Nella maggior parte degli scenari scegliere Avanti finché non si arriva alla pagina Configura windows Firewall della procedura guidata.

   

3. Selezionare almeno un tipo di rete su cui si vogliono usare gli strumenti remoti. Se i computer sono connessi tramite un dominio, è necessario scegliere il primo elemento. Se i computer sono connessi tramite un gruppo di lavoro o un gruppo home, scegliere il secondo o il terzo elemento in base alle esigenze.

   Selezionare quindi Fine per avviare il debugger remoto.

4. Al termine della configurazione, viene visualizzata la finestra Debugger remoto.

   

   Il debugger remoto è ora in attesa di una connessione. Usare il nome del server e il numero di porta visualizzati per impostare la configurazione della connessione remota in Visual Studio.

Per arrestare il debugger remoto, selezionare File>Esci. È possibile riavviarlo dal menu Start o dalla riga di comando:

<Remote debugger installation directory>\msvsmon.exe

Nota

Se è necessario aggiungere autorizzazioni per altri utenti, modificare la modalità di autenticazione o il numero di porta per il debugger remoto, vedere Configurare il debugger remoto.

Eseguire il debug remoto del progetto

Il debugger non può distribuire applicazioni desktop Visual C# o Visual Basic in un computer remoto, ma è comunque possibile eseguirne il debug in remoto come indicato di seguito. La procedura seguente presuppone che si voglia eseguirne il debug in un computer denominato MJO-DL, come illustrato nella figura seguente.

1. Creare un progetto WPF denominato MyWpf.

   Se si sta tentando di eseguire il debug remoto di un'app MAUI invece di WPF, vedere Debug remoto di un'app MAUI .NET in Windows.

2. Impostare un punto di interruzione in un punto qualsiasi del codice facilmente raggiungibile.

   Ad esempio, è possibile impostare un punto di interruzione in un gestore di pulsanti. A tale scopo, aprire MainWindow.xaml e aggiungere un controllo Button dalla casella degli strumenti, quindi fare doppio clic sul pulsante per aprire il relativo gestore.

3. In Esplora Soluzioni, fai clic con il pulsante destro del mouse sul progetto e scegli Proprietà .

4. Nella pagina Proprietà, scegliere la scheda Debug.

   Per i progetti C# destinati a .NET Core o .NET 5+, a partire da Visual Studio 2022, scegliere l'interfaccia utente dei profili di avvio debug dalla scheda debug per configurare le impostazioni per il debug remoto.

   

   In caso contrario, per .NET Framework si modificano le impostazioni di debug remoto direttamente nella scheda Debug.

   

5. Assicurati che la casella di testo cartella di lavoro sia vuota.

6. Scegliere Usa macchina remotae digitare nomemacchina:porta nella casella di testo. Il numero di porta viene visualizzato nella finestra del debugger remoto. Il numero di porta incrementa 2 in ogni versione di Visual Studio.

   In questo esempio usare:

   MJO-DL:4026 su Visual Studio 2022

7. Assicurarsi che Abilita debug del codice nativo non sia selezionato.

8. Costruire il progetto.

9. Creare una cartella nel computer remoto con lo stesso percorso della cartella debug nel computer di Visual Studio: <percorso di origine>\MyWPF\MyWPF\bin\Debug.

10. Copiare il file eseguibile appena compilato dal computer di Visual Studio nella cartella appena creata nel computer remoto.

    Cautela

    Non apportare modifiche al codice o alla ricompilazione altrimenti dovrai ripetere questo passaggio. Il file eseguibile copiato nel computer remoto deve corrispondere esattamente all'origine locale e ai simboli.

    È possibile copiare il progetto manualmente, usare XCopy, Robocopy, PowerShell o altre opzioni.

11. Assicurarsi che il debugger remoto sia in esecuzione nel computer di destinazione .In caso contrario, cercare Debugger remoto nel menu Start). La finestra del debugger remoto è simile alla seguente.

    

12. In Visual Studio avviare il debug (Debug > Avvia debugo F5).

13. Se richiesto, immettere le credenziali di rete per connettersi al computer remoto.

    Le credenziali necessarie variano a seconda della configurazione di sicurezza della rete. Ad esempio, in un computer di dominio è possibile immettere il nome di dominio e la password. In un computer non di dominio è possibile immettere il nome del computer e un nome di account utente valido, ad esempio MJO-DL\name@something.com, insieme alla password corretta.

    Si noterà che la finestra principale dell'applicazione WPF è aperta nel computer remoto.

14. Se necessario, intervenire per raggiungere il punto di interruzione. Si noterà che il punto di interruzione è attivo. Se non lo è, i simboli dell'applicazione non sono stati caricati. Riprovare e, se non funziona, ottenere informazioni sul caricamento dei simboli e su come risolverli in Informazioni sui file di simboli e sulle impostazioni dei simboli di Visual Studio.

15. Nel computer di Visual Studio si noterà che l'esecuzione è stata arrestata nel punto di interruzione.

    Se sono presenti file non di codice che devono essere usati dall'applicazione, è necessario includerli nel progetto di Visual Studio. Creare una cartella di progetto per i file aggiuntivi (in Esplora soluzioni fare clic su Aggiungi > Nuova cartella). Aggiungere quindi i file alla cartella (in Esplora soluzioni fare clic su Aggiungi > elemento esistentee quindi selezionare i file). Nella pagina Proprietà per ogni file, impostare Copia nella directory di output su Copia sempre.

Eseguire il debug remoto di un'app MAUI .NET in Windows

Le app MAUI .NET sono app in pacchetto che devono essere registrate durante la distribuzione, non solo copiate in un computer remoto. Per eseguire il debug remoto, è possibile distribuire una versione non in pacchetto dell'app.

Usare uno dei metodi seguenti per eseguire il debug remoto:

• Pubblicare l'app nel dispositivo remoto come app non in pacchetto usando i passaggi descritti in Usare l'interfaccia della riga di comando per pubblicare app MAUI .NET non in pacchetto per Windowse quindi seguire la procedura descritta in questo articolo per eseguire il debug remoto. Salta i passaggi per copiare l'app.

• Seguire i passaggi descritti in questo articolo, inclusi i passaggi per creare un profilo di avvio di debug per il progetto. Prima di avviare il debug, modificare manualmente il file di launchSettings.json, sostituendo il valore Projectcon MsixPackage, come illustrato di seguito.

  "Remote Profile": {
    "commandName": "MsixPackage",
    "remoteDebugEnabled": true,
    "remoteDebugMachine": "170.200.20.22",
    "authenticationMode": "None"
  }
  

  Quando si avvia il debug, questo metodo distribuisce prima una versione non in pacchetto dell'app e la avvia.

  Nota

  Non è possibile modificare launchSettings.json nella finestra di dialogo Debug profilo di avvio dopo aver modificato il valore in MsixPackage.

Configurare il debug con simboli remoti

Dovrebbe essere possibile eseguire il debug del codice con i simboli generati nel computer di Visual Studio. Le prestazioni del debugger remoto sono molto migliori quando si usano simboli locali. Se è necessario usare i simboli remoti, è necessario indicare al monitor di debug remoto di cercare i simboli nel computer remoto.

È possibile usare l'opzione della riga di comando msvsmon seguente per usare i simboli remoti per il codice gestito: Msvsmon /FallbackLoadRemoteManagedPdbs

Per altre informazioni, vedere la Guida al debug remoto (premere F1 nella finestra del debugger remoto oppure fare clic su Guida > Utilizzo).

Contenuto correlato

• debug in Visual Studio
• Esaminare prima il debugger
• Configurare Windows Firewall per il debug remoto
• assegnazioni di porte del debugger remoto
• Debug remoto di ASP.NET su un computer IIS remoto
• errori di debug remoto e risoluzione dei problemi