Editar e continuar (Visual C#)

  • Artigo

Com a Recarga Dinâmica do C#, ou Editar e Continuar para C#, você pode fazer alterações em seu código no modo de interrupção ou execução enquanto estiver depurando. As alterações podem ser aplicadas sem precisar interromper e reiniciar a sessão de depuração.

A experiência básica da Recarga Dinâmica funciona com a maioria dos tipos de aplicativos .NET e versões da estrutura. Isso inclui o .NET Framework, o .NET Core e o .NET 5+ (para C# e Visual Basic, conforme aplicável). A expectativa neste cenário é que, se você estiver usando o depurador, pressuponha que a Recarga Dinâmica está disponível para você e experimente.

A Recarga Dinâmica tem suporte para a maioria das alterações que você pode querer fazer durante uma sessão de depuração, mas existem algumas exceções. Por exemplo, não há suporte para Recarga Dinâmica 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, confira 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, aparecerá uma caixa de mensagem informando que não há suporte para a Recarga Dinâmica.

Usar a Recarga Dinâmica

O Recarga Dinâmica do C# ocorre automaticamente quando você faz alterações de código no modo de depuração e, em seguida, continua a depuração usando Continuar, Etapa ou Definir Próxima Instrução. Se definir Recarga Dinâmica ao salvar arquivo como verdadeiro, isso também ocorrerá automaticamente ao salvar um arquivo.

Para habilitar ou desabilitar a Recarga Dinâmica:

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

  2. Abra Ferramentas>Opções>Depuração>Recarga Dinâmica do .NET/C++, selecione ou desmarque a caixa de seleção Habilitar Recarga Dinâmica e Editar e Continuar ao depurar.

A configuração entra em vigor quando você inicia ou reinicia a sessão de depuração.

Para usar a experiência clássica Editar e Continuar:

  1. Durante a depuração, no modo de interrupção, faça uma alteração no código-fonte.

  2. No menu Depuração, clique em Continuar, Etapa ou Definir Próxima Instrução. A depuração continua com o novo código compilado.

Não há suporte de Editar e Continuar a alguns tipos de alterações de código. Para obter mais informações, confira Alterações de código com suporte (C# e Visual Basic).

Com a função Editar e Continuar no C#, é possível fazer alterações em seu código no modo de interrupção ou execução durante a depuração. As alterações podem ser aplicadas sem precisar interromper e reiniciar a sessão de depuração. No modo de execução, o editor de origem é somente leitura.

Há suporte para Editar e Continuar na UWP em Windows 10 ou posterior, e aplicativos x86 e x64 direcionados à área de trabalho do .NET Framework 4.6 ou versões posteriores (o .NET Framework é apenas uma versão da área de trabalho).

Editar e Continuar dá suporte à maioria das alterações que você talvez queira fazer durante uma sessão de depuração, mas há algumas exceções. Não há suporte à edição e continuação em código de integração CLR (common language runtime) otimizado, misto ou SQL Server. Para obter informações sobre outros cenários sem suporte, confira Alterações de código com suporte (C# e Visual Basic). Se você tentar editar e continuar em um desses cenários, uma caixa de mensagem será exibida informando que Não há suporte a Editar e Continuar.

Para obter informações sobre outros cenários sem suporte, confira 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, aparecerá uma caixa de mensagem informando que não há suporte para a Recarga Dinâmica.

Usar Editar e Continuar

O modo Editar e Continuar para C# ocorre automaticamente quando você faz alterações de código no modo de interrupção e, em seguida, continua a depuração usando Continuar, Etapaou Definir Próxima Instrução ou avalia uma função em uma janela de depurador.

Para habilitar ou desabilitar o modo Editar e Continuar:

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

  2. Em Ferramentas>Opções (ou Depurar>Opções) >Depuração>Geral, selecione ou limpe 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 Editar e Continuar:

  1. Durante a depuração, no modo de interrupção, faça uma alteração no código-fonte.

  2. No menu Depurar, clique em Continuar, Etapa ou Definir Próxima Instrução ou avalie uma função em uma janela de depuração.

    A depuração continua com o novo código compilado.

Não há suporte de Editar e Continuar a alguns tipos de alterações de código. Para obter mais informações, confira Alterações de código com suporte (C# e Visual Basic).

Conteúdo relacionado