Partilhar via


Como interromper quando uma exceção é lançada

O depurador pode interromper a execução do aplicativo imediatamente quando ocorrer uma exceção, oferecendo uma chance de depurar a exceção antes que um manipulador seja invocado.

Se você estiver depurando com o Apenas Meu Código habilitado, o comportamento será ligeiramente diferente. Com o Apenas Meu Código habilitado, o depurador ignora as exceções de primeira tentativa do Common Language Runtime (CLR) que são geradas fora do Meu Código e não passam por ele. Se a exceção estiver completamente sem tratamento, no entanto, o depurador sempre interromperá.

Dica

Quando você define o depurador para interromper quando uma exceção do CLR é lançada e o depurador é interrompido em uma exceção do CLR, a linha realçada pelo depurador pode estar ligeiramente apagada em alguns casos.Isso pode ocorrer, por exemplo, se você lançar uma exceção do código gerenciado em uma instrução if.O depurador destaca a linha com a próxima instrução do CLR a ser executada, que é a linha após throw, e não a linha com throw.

Ao usar a caixa de diálogo Exceções

Por padrão, a caixa de diálogo Exceções relaciona as exceções mais comuns em cada categoria. Você pode adicionar suas próprias exceções e excluir exceções adicionadas. O Visual Studio salva a lista de exceções adicionadas com os dados da solução para que as exceções estejam disponíveis na próxima vez que você abrir e executar o projeto.

Dica

A caixa de diálogo Exceções fornece teclas para definir controles sem usar o mouse.As teclas de acesso são indicadas por sublinhado nos rótulos do controle.Se você tiver temas do Windows desabilitados, o sublinhado não estará visível, embora as teclas de acesso ainda funcionem.Para exibir a tecla de acesso sublinhada, ative os temas do Windows usando o Painel de Controle do Windows.

Para obter mais informações, consulte Como: adicionar novas exceções e Como: excluir exceções adicionadas pelo usuário.

Para interromper a execução quando uma exceção é lançada

  1. No menu Depurar, clique em Exceções.

    Dica

    Se o comando Exceções não aparecer no menu Depuração, você poderá adicioná-lo.Para obter mais informações, consulte To add the Exceptions command to the Debug menu.

  2. Na caixa de diálogo Exceções, selecione Lançada para uma categoria inteira de exceções, por exemplo, Exceções do Common Language Runtime.

    -ou-

    Expanda o nó para uma categoria de exceções, por exemplo, Exceções do Common Language Runtime e selecione Lançada para uma exceção específica dentro dessa categoria.

Para adicionar os comandos de Exceção ao menu Depurar

  1. No menu Ferramentas, clique em Personalizar.

    A caixa de diálogo Personalizar aparecerá.

  2. Clique na guia Comandos e, na lista Barra de menus, clique em Depurar.

  3. Clique em Adicionar Comando.

  4. Em Categorias, na caixa de diálogo Adicionar Comando, clique em Depurar.

  5. Em Comandos, clique em Exceções e clique em OK.

  6. (Opcional) Você pode clicar em Mover para baixo para ajustar a posição do comando de Exceções no menu Depurar.

  7. Clique em Fechar.

Consulte também

Tarefas

Como interromper exceções sem tratamento do usuário

Conceitos

Tratamento de exceções (depuração)

Apenas Meu Código