Depurar usando o Depurador Just-In-Time no Visual Studio

Depuração Just-In-Time pode iniciar o Visual Studio automaticamente quando um aplicativo em execução fora do Visual Studio apresenta erros ou falha. Com a depuração Just-In-Time, você pode testar aplicativos fora do Visual Studio e abrir o Visual Studio para começar a depuração quando ocorrer um problema.

A Depuração Just-In-Time funciona para aplicativos da área de trabalho do Windows. Ele não funciona para Aplicativos Universais do Windows ou para código gerenciado hospedado em um aplicativo nativo, como Visualizadores.

Habilitar ou desabilitar a depuração Just-In-Time no Visual Studio

Quando você trabalha com o depurador Just-In-Time no Visual Studio, as opções de configuração para o depurador são acessíveis nos menus Ferramentas>Opções ou Depuração>Opções. O depurador Just-In-Time está disponível na seçãoDepuração e teste de > individuais do instalador.

Para habilitar ou desabilitar a depuração Just-in-Time:

Se você habilitar o depurador Just-In-Time, mas ele não abrir quando um aplicativo falhar ou ocorrer algum erro, consulte Solucionar problemas de depuração Just-In-Time.

Desabilitar a depuração Just-In-Time do registro do Windows

O depurador Just-In-Time ainda pode estar habilitado mesmo se o Visual Studio não estiver mais instalado no seu computador. Se o Visual Studio não estiver mais instalado, você pode desabilitar a depuração Just-In-Time editando o registro do Windows.

Para desabilitar a depuração Just-In-Time editando o registro:

1. No menu Iniciar do Windows, execute o Editor do Registro (regedit.exe).

2. Na janela Editor do Registro , localize e exclua as seguintes entradas do Registro se elas existirem:

   • HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\Windows NT\CurrentVersion\AeDebug\Debugger

   • HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\.NETFramework\DbgManagedDebugger

   

3. Exclua também as seguintes entradas do Registro se elas existirem:

   • HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\AeDebug\Debugger

   • HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\.NETFramework\DbgManagedDebugger

   Certifique-se de não excluir ou alterar nenhuma outra chave do Registro.

4. Feche a janela Editor do Registro .

Habilitar a depuração Just-In-Time de um Formulário Windows

Por padrão, os aplicativos do Windows Form têm um manipulador de exceção de nível superior que permite que o aplicativo continue em execução se ele puder se recuperar. Se um aplicativo do Windows Forms gerar uma exceção sem tratamento, ele mostrará a seguinte caixa de diálogo:

Para habilitar o Just-In-Time debugging em vez do tratamento de erros padrão do Windows Forms, adicione estas configurações:

• system.windows.forms Na seção do arquivo machine.config ou <nome do aplicativo>.exe.config, defina o valor de jitDebugging para true:

  <configuration>
      <system.windows.forms jitDebugging="true" />
  </configuration>
  

• Em um aplicativo Windows Forms C++ , também defina DebuggableAttribute como true em um arquivo .config ou no seu código. Se você compilar com /Zi e sem /Og, o compilador definirá esse atributo para você. No entanto, se você quiser depurar um build de versão não otimizado, deverá definir DebuggableAttribute adicionando a seguinte linha no arquivo AssemblyInfo.cpp do aplicativo:

  [assembly:System::Diagnostics::DebuggableAttribute(true, true)];
  

  Para obter mais informações, consulte DebuggableAttribute.

Usar depuração Just-in-Time

Este exemplo guia você na depuração Just-In-Time quando um aplicativo gera um erro.

• Você deve ter o Visual Studio instalado para seguir estas etapas. Se você não tiver o Visual Studio, poderá baixar o Visual Studio Community Edition gratuito.

• Verifique se a depuração Just-In-Time está habilitada configurando a opção Habilitar depuração Just-In-Time para esses tipos de código em Ferramentas>Opções.

Para este exemplo, você faz um aplicativo de console em C# no Visual Studio que gera um NullReferenceException.

1. No Visual Studio, crie um aplicativo de console em C# (Arquivo>Novo>Projeto>Visual C#>Aplicativo de Console) chamado ThrowsNullException. Para obter mais informações sobre como criar projetos no Visual Studio, consulte Passo a passo: criar um aplicativo simples.

2. Quando o projeto for aberto no Visual Studio, abra o arquivo Program.cs . Substitua o método Main() pelo código a seguir, que imprime uma linha no console e, em seguida, lança um NullReferenceException:

   static void Main(string[] args)
   {
       Console.WriteLine("we will now throw a NullReferenceException");
       throw new NullReferenceException("this is the exception thrown by the console app");
   }
   

3. Para criar a solução, escolha a configuração Depuração (padrão) ou Release e selecione Compilar>Reconstruir Solução.

   • Para obter a experiência de depuração completa, selecione a configuração de Depuração .

   • Se você selecionar a configuração de Release, deve desativar Just My Code para que este procedimento funcione.

     No painel de Ferramentas>Opções, expanda a seção Todas as Configurações>Depuração>Geral e desmarque a caixa de seleção Habilitar Apenas Meu Código.

     Na caixa de diálogoFerramentas>Opções, expanda a seçãoDepuração>Geral, e desmarque a caixa de seleção Habilitar Apenas Meu Código.

     Quando você desmarcar essa opção, a opção Avisar se nenhum código de usuário na depuração inicial (somente gerenciado) for desabilitada automaticamente.

   Para obter mais informações sobre configurações de build, consulte Noções básicas sobre configurações de build.

4. Abra o aplicativo criado ThrowsNullException.exe na pasta do projeto C# (...\ThrowsNullException\ThrowsNullException\bin\Debug ou ...\ThrowsNullException\ThrowsNullException\bin\Release).

   Você deverá ver a seguinte janela de comando:

   

5. A caixa de diálogo Escolher Depurador Just-In-Time será aberta.

   

   Em Depuradores Disponíveis, selecione Nova instância da sua versão/edição< preferida do >Visual Studio, se ainda não estiver selecionada.

6. Selecione OK.

   O projeto ThrowsNullException é aberto em uma nova instância do Visual Studio, com a execução interrompida na linha que gerou a exceção:

   

Você pode iniciar a depuração neste ponto. Se você estiver depurando um aplicativo real, precisará descobrir por que o código está lançando a exceção.

Solucionar problemas de depuração Just-In-Time

Se a depuração just-In-Time não for iniciada quando um aplicativo falhar, mesmo que ele esteja habilitado no Visual Studio:

• Um problema conhecido do Windows pode estar causando que o depurador Just-In-Time falhe.

  A correção é adicionar um valor DWORD de Auto, com dados do valor1, às seguintes chaves do Registro:

  • HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\AeDebug

  • (Para aplicativos de 32 bits em computadores de 64 bits) HKEY_LOCAL_MACHINE\Software\WOW6432Node\Microsoft\Windows NT\CurrentVersion\AeDebug

• O Relatório de Erros do Windows pode estar assumindo o tratamento de erros em seu computador.

  Para corrigir esse problema, use o Editor do Registro para adicionar um valor DWORD de Disabled, com dados de valor igual a 1, às seguintes chaves do Registro:

  • HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\Windows Error Reporting

  • (Para aplicativos de 32 bits em computadores de 64 bits) HKEY_LOCAL_MACHINE\Software\WOW6432Node\Microsoft\Windows\Windows Error Reporting

  Para obter mais informações, consulte . Configurações de WER.

Você pode ver as seguintes mensagens de erro durante a depuração just-In-Time:

• Não é possível conectar-se ao processo que está falhando. O programa especificado não é um programa do Windows ou MS-DOS.

  O depurador tentou anexar a um processo em execução sob outro usuário.

  Para contornar esse problema, no Visual Studio, abra Depurar>Anexar ao Processo (ou pressione Ctrl + Alt + P) e encontre o processo que você deseja depurar na lista de Processos Disponíveis. Se você não souber o nome do processo, localize a ID de processo no depurador Just-In-Time do Visual Studio. Selecione o processo na lista Processos Disponíveis e selecione Anexar. Selecione Não para ignorar a caixa de diálogo do depurador just-In-Time.

• Não foi possível iniciar o depurador porque nenhum usuário está conectado.

  Não há nenhum usuário conectado ao console, portanto, não há nenhuma sessão de usuário para exibir a janela de diálogo de depuração Just-In-Time.

  Para corrigir esse problema, faça logon no computador.

• Classe não registrada.

  O depurador tentou criar uma classe COM que não está registrada, provavelmente devido a um problema de instalação.

  Para corrigir esse problema, use o Instalador do Visual Studio para reinstalar ou reparar sua instalação do Visual Studio.

Conteúdo relacionado

• Segurança do depurador
• Introdução ao depurador
• Caixa de diálogo Opções, Depuração, Just-In-Time
• Aviso de segurança: anexar a um processo de propriedade de um usuário não autorizado pode ser perigoso. Se as informações a seguir parecerem suspeitas ou você não tiver certeza, não anexe a esse processo