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.")