Como usar o Assistente de Exceção
O Assistente de Exceção, que aparece sempre que uma exceção em tempo de execução ocorre, mostra o tipo de exceção, dicas de solução de problemas e ações corretivas. O Assistente de Exceção também pode ser usado para ver os detalhes de um objeto de exceção.
Uma exceção é um objeto que herda da classe Exception. Uma exceção é lançada pelo código quando um problema ocorre e ela é passada acima da pilha até que o aplicativo a trate ou o programa falhe.
Dica
As opções disponíveis nas caixas de diálogo e os nomes e os locais dos comandos de menu que você vê podem ser diferentes do que é descrito na Ajuda, dependendo da sua edição ou das suas configurações ativas.Esta página de Ajuda foi escrita com as Configurações Gerais de Desenvolvimento em mente.Para alterar as configurações, escolha Importar e Exportar Configurações no menu Ferramentas.Para obter mais informações, consulte Personalizando configurações de desenvolvimento no Visual Studio.
A tabela a seguir lista e descreve as propriedades de um objeto de exceção. Dependendo do tipo de exceção, nem todas podem aparecer.
Propriedade |
Descrição |
|---|---|
Dados |
Um objeto IDictionary que contém os pares de chave/valor definidos pelo usuário. O padrão é uma coleção vazia. |
FileName |
O nome do arquivo que causou a exceção. |
FusionLog |
Arquivo de log que descreve por que uma carga de assembly falhou. |
O link para o arquivo de Ajuda associado à exceção. |
|
Valor numérico codificado atribuído a uma exceção específica. |
|
A instância Exception que causou a exceção atual. Às vezes é útil capturar uma exceção gerada em uma rotina auxiliar e gerar uma nova exceção mais indicativa de erro, assim fornecendo mais informações. Nesses casos, a propriedade InnerException é definida para a exceção original. |
|
Mensagem associada à exceção. Isso é exibido na linguagem especificada pela propriedade CurrentUICulture do segmento que gera a exceção. |
|
Nome do aplicativo ou objeto que causou a exceção. Se Source não tiver sido definido, o nome do assembly onde a exceção originada é retornada. |
|
A representação na forma de cadeia de caracteres das chamadas de método na pilha de chamada no momento em que a exceção atual foi gerada. O rastreamento de pilha inclui o nome do arquivo-fonte e o número da linha de programa se informações de depuração estiverem disponíveis. A StackTrace pode não relatar tantas chamadas de método conforme esperado, devido às transformações de código que ocorrem durante a otimização. O rastreamento de pilha é capturado imediatamente antes de uma exceção ser gerada. |
|
O método que gerou a exceção atual. Se o método que gerou a exceção não estiver disponível e o rastreamento de pilha não for uma referência nula (Nothing no Visual Basic), o TargetSite obtém o método do rastreamento de pilha. Se o rastreamento de pilha for uma referência nula, o TargetSite também retornará uma referência nula. |
Para saber mais sobre um objeto de exceção
- Clique em Exibir Detalhes no painel Ações. Uma caixa de diálogo é exibida mostrando as propriedades da exceção.
Consulte também
Tarefas
Como mapear HRESULTs e exceções
Como corrigir erros de tempo de execução com o Assistente de Exceção
Referência
Caixa de diálogo Assistente de Exceção
Outros recursos
Choosing When to Use Structured and Unstructured Exception Handling