Throw Statement (Visual Basic)
Updated: July 20, 2015
For the latest documentation on Visual Studio 2017 RC, see Visual Studio 2017 RC Documentation.
Throws an exception within a procedure.
Throw [ expression ]
Provides information about the exception to be thrown. Optional when residing in a
Catch statement, otherwise required.
Throw statement throws an exception that you can handle with structured exception-handling code (
Finally) or unstructured exception-handling code (
On Error GoTo). You can use the
Throw statement to trap errors within your code because Visual Basic moves up the call stack until it finds the appropriate exception-handling code.
Throw statement with no expression can only be used in a
Catch statement, in which case the statement rethrows the exception currently being handled by the
Throw statement resets the call stack for the
expression exception. If
expression is not provided, the call stack is left unchanged. You can access the call stack for the exception through the StackTrace property.
The following code uses the
Throw statement to throw an exception:
Assembly: Visual Basic Runtime Library (in Microsoft.VisualBasic.dll)