Configurare modifica e continuazione (C#, VB, C++)

È possibile disabilitare o abilitare ricaricamento rapido, precedentemente denominato Modifica e continuazione, dal menuOpzioni> di Visual Studio in fase di progettazione. Il ricaricamento rapido funziona solo nelle compilazioni di debug. Per altre informazioni, vedere Ricaricamento rapido.

Per C++ nativo, il ricaricamento rapido richiede l'uso dell'opzione /INCREMENTAL . Per altre informazioni sui requisiti delle funzionalità in C++, vedere questo post di blog e Modifica e continuazione (C++).

Annotazioni

Se IntelliTrace è abilitato e si raccolgono sia gli eventi IntelliTrace che le informazioni sulle chiamate, il ricaricamento rapido è disabilitato. Per altre informazioni, vedere IntelliTrace.

Abilitare e configurare ricaricamento rapido

È possibile configurare ricaricamento rapido selezionando Impostazioni dal pulsante a discesa Ricaricamento rapido.

In alternativa, aprire il riquadro Strumenti>Opzioni e modificare le opzioni nella sezione Tutte le impostazioni>Debugging>.NET/C++ Ricaricamento rapido. Sono disponibili le opzioni seguenti:

• Abilita ricaricamento rapido: usare la funzionalità Ricaricamento rapido con il codice .NET e C++ quando l'app è in esecuzione con il debugger collegato (F5).

• Applica automaticamente le modifiche alla continuazione (solo nativa): Visual Studio compila automaticamente e applica tutte le modifiche di codice in sospeso apportate quando si continua il processo da uno stato di interruzione. Se non è selezionata, è possibile scegliere di applicare le modifiche usando la voce Applica modifiche al codice dal menu Debug .

• Avvisa di codice non aggiornato (solo nativo): ottenere avvisi sul codice non aggiornato.

• Abilita quando non si esegue il debug: abilita il ricaricamento rapido quando l'app viene eseguita senza il debugger collegato (CTRL + F5).

• Applica al salvataggio del file: applica le modifiche quando il file viene salvato.

• Verbosità del registro: impostare il livello di registrazione quando il ricaricamento rapido è abilitato: Minimo, Dettagliato o Diagnostico.

Per il ricaricamento rapido di .NET, è anche possibile controllare se il ricaricamento rapido è disponibile a livello di progetto modificando il file dilaunchSetting.json del progetto .NET 6+ e impostando hotReloadEnabled su false.

Esempio:

{
  "profiles": {
    "Console": {
      "commandName": "Project",
      "hotReloadEnabled": false
    }
  }
}

Configurare il riavvio automatico

Il ricaricamento rapido può riavviare automaticamente il processo dell'app quando viene apportata una modifica non supportata (detta anche modifica scortese) anziché terminare l'intera sessione di debug. Per abilitare questa operazione, modificare il file di progetto per aggiungere la dichiarazione di proprietà seguente.

<PropertyGroup>
  <HotReloadAutoRestart>true</HotReloadAutoRestart>
</PropertyGroup>

È anche possibile impostare questa proprietà in un file Directory.Build.props . Il riavvio automatico funziona per i tipi di progetto in cui un riavvio rapido del processo è fattibile (ad esempio, alcuni progetti Aspira o Web), in modo da poter continuare il debug con un'interruzione minima.

Si tratta di un riavvio basato su processo. Ad esempio, se si esegue il debug di diversi progetti, vengono ricompilati e riavviati solo i progetti modificati e tutti i progetti dipendenti.

Configurare il ricaricamento rapido per Razor

Eseguendo il cohosting del compilatore Razor all'interno del processo Roslyn, la modifica di un file con estensione razor durante il ricaricamento rapido è più veloce ed efficiente. Il cohosting migliora anche l'affidabilità complessiva quando si usa il ricaricamento rapido.

Per abilitare il cohosting, selezionare Strumenti>Opzioni e quindi cercare cohost. Selezionare o deselezionare l'impostazione Usa il server Cohost Roslyn per Razor (richiede il riavvio). Se si abilita questa opzione, riavviare Visual Studio. Il cohosting è abilitato per impostazione predefinita.

Arrestare le modifiche al codice

Mentre Hot Reload è in fase di applicazione delle modifiche al codice, è possibile arrestare l'operazione.

Attenzione

L'arresto delle modifiche al codice gestito può produrre risultati imprevisti. L'applicazione di modifiche al codice gestito è in genere un processo rapido, quindi raramente è necessario arrestare le modifiche al codice gestito.

Per interrompere l'applicazione delle modifiche al codice:

• Scegliere Interrompi applicazione di modifiche al codice dal menu Debug .

  Questa voce di menu è visibile solo quando vengono applicate modifiche al codice.

  Se si sceglie questa opzione, non viene eseguito il commit delle modifiche al codice.