Compartilhar via


Instrução Throw (Visual Basic)

Gera uma exceção dentro de um procedimento.

Sintaxe

Throw [ expression ]

Parte

expression
Fornece informações sobre a exceção a ser gerada. Opcional ao residir em uma instrução Catch, caso contrário, necessário.

Comentários

A instrução Throw gera 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ção não estruturado (On Error GoTo). Você pode usar a instrução Throw para capturar erros em seu código porque o Visual Basic move a pilha de chamadas até encontrar o código de tratamento de exceção apropriado.

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

A instrução Throw redefine a pilha de chamadas para a exceção expression. Se expression não for fornecido, a pilha de chamadas permanecerá inalterada. Você pode acessar a pilha de chamadas para a exceção por meio da propriedade StackTrace.

Exemplo

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

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

Confira também