Utilisation d'exceptions (Guide de programmation C#)

Article
01/07/2009

Mise à jour : novembre 2007

En C#, les erreurs qui se produisent dans le programme au moment de l'exécution sont propagées à travers le programme à l'aide du mécanisme des exceptions. Les exceptions sont levées par le code qui rencontre une erreur et interceptées par le code qui peut corriger l'erreur. Les exceptions peuvent être levées par le CLR (Common Language Runtime) du .NET Framework, ou par code dans un programme. Une fois qu'une exception est levée, elle se propage jusqu'en haut de pile des appels, jusqu'à ce qu'une instruction catch soit trouvée pour l'exception. Les exceptions non interceptées sont traitées par un gestionnaire d'exceptions générique fourni par le système qui affiche une boîte de dialogue.

Les exceptions sont représentées par des classes dérivées de Exception. Cette classe identifie le type d'exception et contient les propriétés détaillées sur l'exception. Lever une exception implique de créer une instance d'une classe dérivée d'exception, de configurer les propriétés de l'exception, le cas échéant, puis de lever l'objet à l'aide du mot clé throw. Par exemple :

class CustomException : Exception
{
    public CustomException(string message)
    {

    }

}
private static void TestThrow()
{
    CustomException ex =
        new CustomException("Custom exception in TestThrow()");

    throw ex;
}

Après avoir levé une exception, le runtime vérifie l'instruction actuelle pour voir si elle se trouve au sein d'un bloc try. Si tel est le cas, tous les blocs catch associés au bloc try sont contrôlés afin de vérifier s'ils peuvent intercepter l'exception. Les blocs Catch spécifient normalement des types d'exceptions ; si le type du bloc catch est du même type que l'exception, ou qu'une classe de base de l'exception, le bloc catch peut gérer la méthode. Par exemple :

static void TestCatch()
{
    try
    {
        TestThrow();
    }
    catch (CustomException ex)
    {
        System.Console.WriteLine(ex.ToString());
    }
}

Si l'instruction qui lève une exception ne se trouve pas à l'intérieur d'un bloc try, ou si le bloc try qui la contient n'a pas de bloc catch correspondant, le runtime vérifie que la méthode d'appel dispose d'une instruction try et de blocs catch. Le runtime continue jusqu'à la pile appelante, à la recherche d'un bloc catch compatible. Une fois le bloc catch trouvé et exécuté, le contrôle est passé à l'instruction suivante après le bloc catch.

Une instruction try peut contenir plusieurs blocs catch. La première instruction catch qui peut gérer l'exception est exécutée ; toutes les instructions catch suivantes, même compatibles, sont ignorées. Par conséquent, les blocs catch doivent toujours être classés du plus spécifique (ou plus dérivé) au moins spécifique. Par exemple :

static void TestCatch2()
{
    System.IO.StreamWriter sw = null;
    try
    {
        sw = new System.IO.StreamWriter(@"C:\test\test.txt");
        sw.WriteLine("Hello");
    }

    catch (System.IO.FileNotFoundException ex)
    {
        System.Console.WriteLine(ex.ToString());  // put the more specific exception first
    }

    catch (System.IO.IOException ex)
    {
        System.Console.WriteLine(ex.ToString());  // put the less specific exceptions last
    }
    finally 
    {
        sw.Close();
    }

    System.Console.WriteLine("Done");  // this statement is executed after the catch block
}

Avant que le bloc catch ne soit exécuté, le runtime vérifie la présence de blocs finally. Les blocs Finally permettent au programmeur de nettoyer tout état ambigu qui pourrait subsister après une interruption de bloc try ou de libérer les ressources externes (handles graphiques, connexions de bases de données ou flux de fichier) sans attendre que le garbage collector du runtime ne finalise les objets. Par exemple :

static void TestFinally()
{
    System.IO.FileStream file = null;
    //Change the path to something that works on your machine
    System.IO.FileInfo fileInfo = new System.IO.FileInfo(@"C:\file.txt");

    try
    {
        file = fileInfo.OpenWrite();
        file.WriteByte(0xF);
    }
    finally
    {
        // Closing the file allows you to reopen it immediately - otherwise IOException is thrown.
        if (file != null)
        {
            file.Close();
        }
    }

    try
    {
        file = fileInfo.OpenWrite();
        System.Console.WriteLine("OpenWrite() succeeded");
    }
    catch (System.IO.IOException)
    {
        System.Console.WriteLine("OpenWrite() failed");
    }
}

Si WriteByte() a levé une exception, le code du deuxième bloc try qui essaie de rouvrir le fichier échoue si file.Close() n'est pas appelé et le fichier reste verrouillé. Étant donné que les blocs finally sont exécutés même lorsqu'une exception est levée, le bloc finally de l'exemple précédent autorise le fichier à être fermé correctement et permet d'éviter une erreur.

Si aucun bloc catch compatible n'est trouvé sur la pile des appels après qu'une exception ait été levée, l'une des trois situations suivantes se produit :

Si l'exception se trouve dans un destructeur, le destructeur est abandonné et le destructeur de base, s'il y en a un, est appelé.
Si la pile des appels contient un constructeur statique, ou un initialiseur de champ statique, une TypeInitializationException est levée, avec l'exception d'origine assignée à la propriété InnerException de la nouvelle exception.
Si le début du thread est atteint, le thread est terminé.

Partager via

Utilisation d'exceptions (Guide de programmation C#)

Voir aussi

Concepts

Référence

Ressources supplémentaires