Configurar Editar e Continuar (C#, VB, C++)

Você pode desabilitar ou habilitar a Recarga Dinâmica, anteriormente chamada Editar e Continuar, no menuOpções das > do Visual Studio no momento do design. A Recarga Dinâmica funciona apenas em builds de depuração. Para obter mais informações, consulte Hot Reload.

Para C++ nativo, a recarga dinâmica requer o uso da opção /INCREMENTAL. Para obter mais informações sobre os requisitos de recursos em C++, confira esta postagem no blog e Editar e Continuar (C++).

Editar e Continuar é um recurso de economia de tempo que permite que você faça alterações no código-fonte enquanto o programa está no modo de interrupção. Quando você retoma a execução do programa escolhendo um comando de execução como Continuar ou Etapa, Editar e Continuar aplica automaticamente as alterações de código com algumas limitações. Isso permite que você faça alterações no código durante uma sessão de depuração, em vez de precisar parar, recompilar todo o programa e reiniciar a sessão de depuração.

Você pode desabilitar ou habilitar Editar e Continuar na caixa de diálogo Opções do Visual Studio no momento do design. Editar e Continuar só funciona em builds de depuração. Para obter mais informações, confira Editar e Continuar.

Para C++ nativo, Editar e Continuar exige o uso da opção /INCREMENTAL. Para obter mais informações sobre os requisitos de recursos em C++, confira esta postagem no blog e Editar e Continuar (C++).

Habilitar e configurar o Recarregamento Dinâmico

Você pode configurar a Recarga Rápida selecionando Configurações no menu suspenso Recarga Rápida.

Ou abra o painel Ferramentas>Opções e ajuste as opções na seção Todas as Configurações>Depuração>.NET/C++ Recarregamento Dinâmico. As seguintes opções estão disponíveis:

• Habilitar Hot Reload: use o recurso de Hot Reload com código .NET e C++ quando o aplicativo estiver em execução com o depurador anexado (F5).

• Aplicar alterações automaticamente ao continuar (apenas nativo): o Visual Studio compila e aplica automaticamente quaisquer alterações de código pendentes quando você continua o processo a partir de um estado de suspensão. Se não estiver selecionado, você poderá optar por aplicar alterações usando o item Aplicar Alterações de Código no menu Depurar .

• Avisar sobre o código obsoleto (somente nativo): Receba avisos sobre código obsoleto.

• Habilitar quando não estiver depurando: habilita o recarregamento frequente quando seu aplicativo é executado sem o depurador anexado (Ctrl + F5).

• Aplicar no salvamento do arquivo: Aplica alterações quando o arquivo é salvo.

• Verbosidade de log: defina o nível de registro em log quando a Recarga Instantânea estiver habilitada: Mínimo, Detalhado ou Diagnóstico.

Ou, abra a caixa de diálogo Ferramentas>Opções e ajuste as opções na seção Depuração>.NET/C++ Atualização Instantânea. As seguintes opções estão disponíveis:

• Habilitar Hot Reload: Habilita o Hot Reload ao iniciar com o depurador anexado (F5).

• Habilitar o Recarregamento Dinâmico ao iniciar sem depuração: habilita o recarregamento frequente ao iniciar sem o depurador anexado (Ctrl+F5).

• Aplicar a recarga ativa no Salvamento de Arquivos: aplica alterações de código ao salvar o arquivo.

• Verbosidade do log: filtra a quantidade de informações exibidas na janela de Saída do Hot Reload.

No C++, você pode definir opções extras abrindo Ferramentas>Opções>Depuração>Geral. Verifique se Habilitar Recarga Dinâmica está selecionada e defina as outras opções:

• Aplicar alterações ao continuar (somente nativo): o Visual Studio aplica e compila automaticamente as alterações de código pendentes feitas ao retomar o processo de um estado de interrupção. Se não estiver selecionado, você poderá optar por aplicar alterações usando o item Aplicar Alterações de Código no menu Depurar .

• Avisar sobre o código obsoleto (somente nativo): Receba avisos sobre código obsoleto.

Para o .NET Hot Reload, você também pode controlar se o Hot Reload está disponível no nível do projeto modificando o arquivo de launchSetting.json do projeto do .NET 6+ e definindo hotReloadEnabled para false.

Exemplo:

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

Habilitar ou desabilitar Editar e Continuar

1. Se você estiver em uma sessão de depuração, interrompa a depuração (Depurar>Parar Depuração ou +).

2. Em Ferramentas>Opções> (ou Depurar>Opções) >Depuração>Geral, selecione Editar e Continuar no painel direito.

   Nota

   Se o IntelliTrace estiver habilitado e você coletar tanto eventos do IntelliTrace quanto informações de chamada, o recurso Editar e Continuar será desabilitado. Para obter mais informações, consulte IntelliTrace.

3. Para o código C++, verifique se Habilitar Edição Nativa e Continuar está selecionado e defina as outras opções:

   • Aplicar alterações ao continuar (somente nativo): o Visual Studio compila e aplica automaticamente as alterações de código pendentes feitas ao prosseguir o processo a partir de um estado de pausa. Se não estiver selecionado, você poderá optar por aplicar alterações usando o item Aplicar Alterações de Código no menu Depurar .

   • Avisar sobre o código obsoleto (somente nativo): Receba avisos sobre código obsoleto.

4. Selecione OK.

Configurar a reinicialização automática

O Hot Reload pode reiniciar automaticamente o processo do aplicativo quando uma alteração sem suporte (também chamada de edição rude) é feita, em vez de encerrar toda a sessão de depuração. Para habilitar isso, edite o arquivo de projeto para adicionar a declaração de propriedade a seguir.

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

Você também pode definir essa propriedade em um arquivo Directory.Build.props . A reinicialização automática funciona para tipos de projeto em que uma reinicialização rápida do processo é viável (por exemplo, alguns projetos Aspire ou Web), para que você possa continuar a depuração com interrupção mínima.

Essa é uma reinicialização baseada em processo. Por exemplo, se você estiver depurando vários projetos, somente os projetos alterados e quaisquer projetos dependentes serão recriados e reiniciados.

Configurar o recarregamento frequente para o Razor

Ao integrar o compilador Razor dentro do processo Roslyn, a edição de um arquivo .razor durante o Hot Reload é mais rápida e eficiente. A cohosagem também melhora a confiabilidade geral ao usar o Hot Reload.

Para habilitar o cohosting, selecione Ferramentas>Opções, e então pesquise por cohost. Selecione ou desmarque a configuração Usar o servidor Cohost roslyn para Razor (requer reinicialização). Se você habilitar essa opção, reinicie o Visual Studio. A cohosting está habilitada por padrão.

Enquanto o Hot Reload está no processo de aplicar alterações de código, é possível interromper a operação.

Enquanto Editar e Continuar estiver no processo de aplicação de alterações de código, você pode interromper a operação.