Partilhar via


Instrução Throw (Visual Basic)

Lança uma exceção dentro de um procedimento.

Sintaxe

Throw [ expression ]

Parte

expression
Fornece informações sobre a exceção a ser lançada. Opcional quando residir em uma Catch declaração, caso contrário, exigido.

Observações

A Throw instrução lança uma exceção que você pode manipular com código estruturado de tratamento de exceções (Try...Catch...Finally) ou código de tratamento de exceções não estruturado (On Error GoTo). Você pode usar a Throw instrução para intercetar erros dentro do seu código porque o Visual Basic move para cima a pilha de chamadas até encontrar o código de tratamento de exceção apropriado.

Uma Throw instrução sem expressão só pode ser usada em uma Catch instrução, caso em que a instrução relança a exceção que está sendo tratada atualmente pela Catch instrução.

A Throw instrução redefine a pilha de chamadas para a expression exceção. Se expression não for fornecida, a pilha de chamadas será mantida inalterada. Você pode acessar a pilha de chamadas para a exceção através da StackTrace propriedade.

Exemplo

O código a seguir usa a Throw instrução para lançar uma exceção:

' Throws a new exception.
Throw New System.Exception("An exception has occurred.")

Consulte também