Throw (Instrucción, Visual Basic)Throw Statement (Visual Basic)

Produce una excepción dentro de un procedimiento.Throws an exception within a procedure.

SintaxisSyntax

Throw [ expression ]

PartePart

expression
Proporciona información sobre la excepción que se va a producir.Provides information about the exception to be thrown. Opcional cuando reside en una Catch instrucción; de lo contrario, es obligatorio.Optional when residing in a Catch statement, otherwise required.

ObservacionesRemarks

La Throw instrucción produce una excepción que se puede controlar con código estructurado de control de excepciones ( Try ... Catch ...Finally) código de control de excepciones no estructurado ( On Error GoTo ).The Throw statement throws an exception that you can handle with structured exception-handling code (Try...Catch...Finally) or unstructured exception-handling code (On Error GoTo). Puede usar la Throw instrucción para interceptar errores dentro del código porque Visual Basic sube la pila de llamadas hasta que encuentra el código de control de excepciones adecuado.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.

Una Throw instrucción sin expresión solo se puede usar en una Catch instrucción, en cuyo caso la instrucción vuelve a iniciar la excepción que está controlando actualmente la Catch instrucción.A 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 Catch statement.

La Throw instrucción restablece la pila de llamadas de la expression excepción.The Throw statement resets the call stack for the expression exception. Si expression no se proporciona, la pila de llamadas permanece sin cambios.If expression is not provided, the call stack is left unchanged. Puede tener acceso a la pila de llamadas de la excepción a través de la StackTrace propiedad.You can access the call stack for the exception through the StackTrace property.

EjemploExample

En el código siguiente se usa la Throw instrucción para producir una excepción:The following code uses the Throw statement to throw an exception:

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

Vea tambiénSee also