try-catch (Referencia de C#)
La instrucción try-catch consta de un bloque try seguido de una o más cláusulas catch, las cuales especifican controladores para diferentes excepciones. Cuando se produce una excepción, Common Language Runtime (CLR) busca la instrucción catch que controla esta excepción. Si el método que se está ejecutando actualmente no contiene un bloque catch de este tipo, CLR examina el método que llamó al método actual y así sucesivamente en la pila de llamadas. Si no se encuentra ningún bloque catch, CLR muestra al usuario un mensaje de excepción no controlada y detiene la ejecución del programa.
El bloque try contiene el código protegido que puede causar la excepción. Este bloque se ejecuta hasta que se produce una excepción o hasta completarse satisfactoriamente. Por ejemplo, el siguiente intento de convertir un objeto null provoca la excepción NullReferenceException:
object o2 = null;
try
{
int i2 = (int)o2; // Error
}
Aunque la cláusula catch puede utilizarse sin argumentos para detectar cualquier tipo de excepción, no se recomienda este uso. En general, sólo debe detectar las excepciones de las que sepa cómo recuperarse. Por lo tanto, debe especificar siempre un argumento de objeto derivado de System.Exception. Por ejemplo:
catch (InvalidCastException e)
{
}
Es posible utilizar más de una cláusula catch específica en la misma instrucción try-catch. En este caso, el orden de las cláusulas catch es importante, ya que las cláusulas catch se examinan por orden. Las excepciones más específicas se capturan antes que las menos específicas. El compilador genera un error si ordena los bloques catch de forma que nunca se alcance un bloque posterior.
Se puede utilizar una instrucción throw en un bloque catch para volver a producir la excepción capturada por la instrucción catch. En el ejemplo siguiente se extrae información de origen de una excepción IOException y, a continuación, se inicia la excepción en el método primario.
catch (FileNotFoundException e)
{
// FileNotFoundExceptions are handled here.
}
catch (IOException e)
{
// Extract some information from this exception, and then
// throw it to the parent method.
if (e.Source != null)
Console.WriteLine("IOException source: {0}", e.Source);
throw;
}
Puede detectar una excepción y producir otra distinta. Al hacerlo, especifique la excepción que se detectó como excepción interna, como se muestra en el ejemplo siguiente.
catch (InvalidCastException e)
{
// Perform some action here, and then throw a new exception.
throw new YourCustomException("Put your error message here.", e);
}
También puede volver a producir una excepción cuando una condición especificada es true, como se muestra en el ejemplo siguiente.
catch (InvalidCastException e)
{
if (e.Data == null)
{
throw;
}
else
{
// Take some action.
}
}
Desde dentro de un bloque try, inicialice únicamente las variables que se declaran. De lo contrario, puede producirse una excepción antes de que completarse la ejecución del bloque. Por ejemplo, en el siguiente código, la variable n se inicializa dentro del bloque try. Al intentar usar esta variable fuera del bloque try en la instrucción Write(n), se generará un error del compilador.
static void Main()
{
int n;
try
{
// Do not initialize this variable here.
n = 123;
}
catch
{
}
// Error: Use of unassigned local variable 'n'.
Console.Write(n);
}
Para obtener más información sobre catch, vea try-catch-finally.
Ejemplo
En el ejemplo siguiente, el bloque try contiene una llamada al método ProcessString que puede producir una excepción. La cláusula catch contiene el controlador de excepciones, el cual simplemente muestra un mensaje en la pantalla. Cuando se realiza la llamada a la instrucción throw desde dentro de MyMethod, el sistema busca la instrucción catch y muestra el mensaje Exception caught.
class TryFinallyTest
{
static void ProcessString(string s)
{
if (s == null)
{
throw new ArgumentNullException();
}
}
static void Main()
{
string s = null; // For demonstration purposes.
try
{
ProcessString(s);
}
catch (Exception e)
{
Console.WriteLine("{0} Exception caught.", e);
}
}
}
/*
Output:
System.ArgumentNullException: Value cannot be null.
at TryFinallyTest.Main() Exception caught.
* */
En este ejemplo, se utilizan dos instrucciones catch. La excepción más específica, que aparece en primer lugar, se captura primero.
class ThrowTest3
{
static void ProcessString(string s)
{
if (s == null)
{
throw new ArgumentNullException();
}
}
static void Main()
{
try
{
string s = null;
ProcessString(s);
}
// Most specific:
catch (ArgumentNullException e)
{
Console.WriteLine("{0} First exception caught.", e);
}
// Least specific:
catch (Exception e)
{
Console.WriteLine("{0} Second exception caught.", e);
}
}
}
/*
Output:
System.ArgumentNullException: Value cannot be null.
at Test.ThrowTest3.ProcessString(String s) ... First exception caught.
*/
En el ejemplo anterior, si empieza con la cláusula catch menos específica, aparecerá el mensaje de error:
A previous catch clause already catches all exceptions of this or a super type ('System.Exception')
No obstante, para capturar la excepción menos específica, debe reemplazar la instrucción throw por la siguiente:
throw new Exception();
Especificación del lenguaje C#
Para obtener más información, vea la Especificación del lenguaje C#. La especificación del lenguaje es la fuente definitiva de la sintaxis y el uso de C#.
Vea también
Tareas
Cómo: Iniciar excepciones explícitamente
Referencia
try, catch, and throw Statements (C++)
Instrucciones para el control de excepciones (Referencia de C#)
try-finally (Referencia de C#)
Conceptos
Otros recursos
Historial de cambios
Fecha |
Historial |
Motivo |
|---|---|---|
|
Julio de 2010 |
Se han actualizado los ejemplos throw. |
Comentarios de los clientes. |