Instrucción Try...Catch...Finally (Visual Basic)

Actualización: noviembre 2007

Esta instrucción proporciona una manera de controlar algunos o todos los errores posibles que pueden ocurrir en un bloque de código determinado mientras se ejecuta el código.

Try
    [ tryStatements ]
    [ Exit Try ]
[ Catch [ exception [ As type ] ] [ When expression ]
    [ catchStatements ]
    [ Exit Try ] ]
[ Catch ... ]
[ Finally
    [ finallyStatements ] ]
End Try

Partes

• tryStatements
  Opcional. Instrucciones en las que puede ocurrir un error. Puede ser una instrucción compuesta.

• Catch
  Opcional. Se permite utilizar varios bloques Catch. Si se produce una excepción al procesar el bloque Try, cada instrucción Catch se examina en orden textual para determinar si controla la excepción; el parámetro exception representa la excepción que se ha producido.

• exception
  Opcional. Cualquier nombre de variable. El valor inicial de exception es el valor del error producido. Se utiliza con Catch para especificar la captura del error. Si se omite, la instrucción Catch detecta cualquier excepción.

• type
  Opcional. Especifica el tipo de filtro de clase. Si el valor de exception es del tipo especificado en type o de un tipo derivado, el identificador queda enlazado al objeto de excepción.

• When
  Opcional. Una instrucción Catch con una cláusula When sólo detecta las excepciones cuando expression se evalúa como True. Una cláusula When sólo se aplica después de comprobar el tipo de la excepción y expression puede hacer referencia al identificador que representa la excepción.

• expression
  Opcional. Debe ser convertible implícitamente a Boolean. Cualquier expresión que describe un filtro genérico. Se utiliza normalmente para filtrar por número de error. Se utiliza con la palabra clave When para especificar las circunstancias bajo las que se captura el error.

• catchStatements
  Opcional. Instrucciones para controlar los errores que se producen en el bloque Try asociado. Puede ser una instrucción compuesta.

• Exit Try
  Opcional. Palabra clave que interrumpe la ejecución de la estructura Try...Catch...Finally. La ejecución se reanuda con el código que sigue inmediatamente a la instrucción End Try. Se ejecutará la instrucción Finally todavía. No se permite en bloques Finally.

• Finally
  Opcional. Siempre se ejecuta un bloque Finally cuando la ejecución sale de cualquier parte de la instrucción Try.

• finallyStatements
  Opcional. Instrucciones que se ejecutan después de las demás operaciones de procesamiento de error.

• End Try
  Finaliza la estructura Try...Catch...Finally.

Comentarios

Las variables locales de un bloque Try no se encuentran disponibles en un bloque Catch porque se trata de bloques independientes. Si se desea utilizar una variable en más de un bloque, se debe declarar la variable fuera de la estructura Try...Catch...Finally.

El bloque Try contiene código donde puede producirse un error, y el bloque Catch contiene código para controlar cualquier error que se produzca. Si se produce un error en el bloque Try, el control del programa pasa a la instrucción Catch apropiada para su procesamiento. El argumento exception es una instancia de la clase Exception o una clase que se deriva de la clase Exception. La instancia de la clase Exception corresponde al error que se produjo en el bloque Try. La instancia que contiene información sobre el error. Se incluyen, entre otras cosas, el número y el mensaje.

Si una instrucción Catch no especifica un argumento exception, detectará cualquier tipo de excepción del sistema o de la aplicación. Esta variación debe utilizarse siempre como el último bloque Catch en la estructura Try...Catch...Finally, después de detectar todas las excepciones específicas anticipadas. El flujo de control nunca puede alcanzar un bloque Catch situado detrás de Catch sin un argumento exception.

En situaciones de confianza parcial, como una aplicación hospedada en un recurso compartido de red, Try...Catch...Finally no detectará las excepciones de seguridad que se produzcan antes de llamar al método que contiene la llamada. El ejemplo siguiente, si se coloca en un recurso compartido de servidor y se ejecuta desde el mismo, producirá el error: "Sub System.Security.SecurityException: Error de solicitud". Para obtener más información sobre excepciones de seguridad, vea la clase SecurityException.

Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As _
System.EventArgs) Handles Button1.Click
    Try
        Process.Start("https://www.microsoft.com")
    Catch ex As Exception
        MsgBox("Can't load Web page" & vbCrLf & ex.Message)
    End Try
End Sub

En este tipo de situación de confianza parcial, debe colocar la instrucción Process.Start en un procedimiento Sub independiente. La llamada inicial a Sub producirá un error. Esto permite que Try...Catch lo capture antes de que se inicie el procedimiento Sub que contiene Process.Start y se produzca la excepción de seguridad.

Nota:
Si una instrucción Try no contiene al menos un bloque Catch, debe contener un bloque Finally.

Ejemplo

En el siguiente ejemplo simplificado se muestra la estructura de la instrucción Try...Catch...Finally.

Public Sub TryExample()
    Dim x As Integer = 5   ' Declare variables.
    Dim y As Integer = 0
    Try                    ' Set up structured error handling.
        x = x \ y          ' Cause a "Divide by Zero" error.
    Catch ex As Exception When y = 0        ' Catch the error.
        Beep()
        MsgBox("You tried to divide by 0.") ' Show an explanatory message.
    Finally
        Beep()             ' This line is executed no matter what.
    End Try
End Sub

Vea también

Referencia

End (Instrucción)

Err (Objeto, Visual Basic)

Instrucción Exit (Visual Basic)

Instrucción On Error (Visual Basic)

Exception

GoTo (Instrucción)