Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Com Hot Reload ou Edit and Continue para C#, você pode fazer alterações no seu código em modo de pausa ou execução durante a depuração. As alterações podem ser aplicadas sem ter que parar e reiniciar a sessão de depuração.
A experiência básica do Hot Reload funciona com a maioria dos tipos de aplicativos .NET e versões do framework. Isso inclui .NET Framework, .NET Core e .NET 5+ (para C# e Visual Basic, conforme aplicável). A expectativa neste cenário é que, se você estiver usando o depurador, assuma que o Hot Reload está disponível para você e experimente!
O Hot Reload suporta a maioria das alterações que você pode querer fazer durante uma sessão de depuração, mas há algumas exceções. Por exemplo, o Hot Reload não é suportado para código otimizado ou sessões de depuração com o depurador gerenciado e nativo habilitado.
Para obter informações sobre outros cenários sem suporte, consulte Alterações de código com suporte (C# e Visual Basic). Se você tentar aplicar alterações de código com um desses cenários, uma caixa de mensagem será exibida informando que o Hot Reload não é suportado.
Usar Hot Reload
O Hot Reload para C# acontece automaticamente quando se fazem alterações de código no modo de interrupção e, em seguida, se continua a depuração usando Continue, Step ou Set Next Statement. Se você definir Hot Reload no arquivo salvo como true, isso também acontecerá automaticamente ao salvar um arquivo.
Para ativar ou desativar o Hot Reload:
- Se você estiver em uma sessão de depuração, pare de depurar (Debug>Stop Debugging ou Shift + F5).
Abra o painelOpções de > e expanda a seção All Settings>Debugging.NET>/C++ Hot Reload.
Selecione ou desmarque as opções desejadas Ativar Hot Reload para o recurso.
Abra a caixa de diálogo
Ferramentas Opções Depuração .NET/C++ Hot Reload .Selecione ou desmarque as opções desejadas Ativar Hot Reload para o recurso e selecione OK.
A configuração entra em vigor quando você inicia ou reinicia a sessão de depuração.
Para usar a experiência clássica de Editar e Continuar:
Durante a depuração, no modo de pausa, efetue uma alteração no código-fonte.
No menu Depurar , selecione Continuar, Etapa ou Definir próxima instrução. A depuração prossegue com o novo código compilado.
Alguns tipos de alterações de código não são suportados por Editar e Continuar. Para obter mais informações, consulte Alterações de código suportadas (C# e Visual Basic).
Com Editar e Continuar para C#, você pode fazer alterações no seu código no modo de interrupção ou execução durante a depuração. As alterações podem ser aplicadas sem ter que parar e reiniciar a sessão de depuração. No modo de execução, o editor de código-fonte é de leitura somente.
Editar e Continuar é suportado na UWP no Windows 10 ou posterior e em aplicativos x86 e x64 destinados à área de trabalho do .NET Framework 4.6 ou versões posteriores (o .NET Framework é apenas uma versão para desktop).
Editar e Continuar suporta a maioria das alterações que você pode querer fazer durante uma sessão de depuração, mas há algumas exceções. Não há suporte para Editar e Continuar para código de integração otimizado, misto ou CLR (Common Language Runtime) do SQL Server. Para obter informações sobre outros cenários sem suporte, consulte Alterações de código com suporte (C# e Visual Basic). Se você tentar Editar e Continuar com um desses cenários, será exibida uma caixa de mensagem informando que Editar e Continuar não é suportado.
Para obter informações sobre outros cenários sem suporte, consulte Alterações de código com suporte (C# e Visual Basic). Se você tentar aplicar alterações de código com um desses cenários, uma caixa de mensagem será exibida informando que o Hot Reload não é suportado.
Utilizar "Editar e Continuar"
Editar e Continuar para C# acontece automaticamente quando você faz alterações de código no modo de quebra e, em seguida, continua a depuração usando Continuar, Etapa ou Definir Próxima Instrução ou avalia uma função em uma janela do depurador.
Para ativar ou desativar Editar e Continuar:
Se você estiver em uma sessão de depuração, pare de depurar (Debug>Stop Debugging ou Shift+F5).
Em Opções de Ferramentas> (ou Opções de Depuração>)>Depurando>Geral, marque ou desmarque a caixa de seleção Habilitar Editar e Continuar.
A configuração entra em vigor quando você inicia ou reinicia a sessão de depuração.
Para usar o botão Editar e continuar:
Durante a depuração, no modo de pausa, efetue uma alteração no código-fonte.
No menu Depurar , selecione Continuar, Etapa ou Definir próxima instrução ou avalie uma função em uma janela do depurador.
A depuração prossegue com o novo código compilado.
Alguns tipos de alterações de código não são suportados por Editar e Continuar. Para obter mais informações, consulte Alterações de código suportadas (C# e Visual Basic).