Classe Exception no Visual Basic

Para facilitar o uso de manipulação de exceção estruturada, o Visual Basic fornece a capacidade de separar código padrão do código de manipulação de exceção. O código de manipulação de exceção acessa uma instância da classe Exception, que permite que você recupere informações sobre qualquer exceção que você encontrar.

Comentários

Sempre que uma exceção é lançada, o objeto global Err é definido, e uma nova instância da classe Exception é criada.

As propriedades da classe Exception auxiliam na identificação da localidade, tipo e causas de exceções do código. Por exemplo, a propriedade StackTrace lista os métodos chamados que levam à exceção, ajudando você encontrar onde o erro ocorreu no código. A propriedade Message retorna uma mensagem de texto descrevendo o erro; você pode alterá-la para fazer com que uma mensagem "obscura" seja mais fácil de entender. Se você não fornecer uma sequência de caracteres de texto da mensagem de erro, a mensagem padrão será usada. HelpLinkObtém ou define um link para um arquivo de ajuda associado. SourceObtém ou define um string contendo o nome do objeto que está causando o erro ou o nome do assembly que originou a exceção.

ObservaçãoObservação

Evite escrever código que testa por mensagens de erro específicas, já que as mensagens podem alterar entre versões da classe que originalmente produziu-as. Em vez disso, teste pelo tipo de exceção ou use o número da exceção do objeto global Err.

Propriedades da Classe Exception

A tabela a seguir lista e descreve as propriedades da classe Exception.

Propriedade

Descrição

HelpLink

Obtém ou define um link para o arquivo de ajuda associado a essa exceção.

HResult

Obtém ou define HRESULT, um valor numérico codificado que é atribuído a uma exceção específica.

InnerException

Obtém a instância Exception que causou a exceção atual.

Message

Obtém uma mensagem que descreve a exceção atual.

Source

Obtém ou define o nome do aplicativo ou objeto que causou o erro.

StackTrace

Obtém uma representação na forma de sequência de caracteres dos quadros na pilha de chamada no momento em que a exceção atual foi lançada.

TargetSite

Obtém o método que lançou a exceção atual.

Consulte também

Tarefas

A solução de problemas (Visual Basic) de manipulação de exceção

Conceitos

Introdução ao (Visual Basic) de manipulação de exceção

Tipos de erros (Visual Basic)

Visão Geral sobre a Manipulação Estruturada de Exceções para o Visual Basic

Visão geral (Visual Basic) de manipulação de exceção não estruturada

Outros recursos

Tarefas (Visual Basic) de manipulação de exceção