ExceptionHandlingClauseOptions Énumération

Définition

Espace de noms:

System.Reflection

Assembly:

System.Runtime.dll

Identifie des types de clauses de gestion des exceptions.

Cette énumération prend en charge une combinaison au niveau du bit de ses valeurs membres.

C#

[System.Flags]
public enum ExceptionHandlingClauseOptions

Héritage

Object

ValueType

Enum

ExceptionHandlingClauseOptions

Attributs

FlagsAttribute

Champs

Nom	Valeur	Description
Clause	0	La clause accepte toutes les exceptions qui dérivent d'un type spécifié.
Fault	4	La clause est exécutée si une exception se produit, mais pas à la fin du flux de contrôle normal.
Filter	1	La clause contient des instructions spécifiées par l'utilisateur qui déterminent si l'exception doit être ignorée (à savoir, si l'exécution normale doit se poursuivre), gérée par le gestionnaire associé ou passée à la clause suivante.
Finally	2	La clause est exécutée à chaque sortie du bloc try, que ce soit avec un flux de contrôle normal ou à cause d'une exception non gérée.

Exemples

L’exemple de code suivant définit une méthode de test nommée MethodBodyExampleet affiche ses informations de variable locale et ses clauses de gestion des exceptions. La MethodBase.GetMethodBody méthode est utilisée pour obtenir un MethodBody objet pour la méthode de test. La ExceptionHandlingClauses propriété est utilisée pour obtenir une liste d’objets ExceptionHandlingClause et afficher leurs propriétés.

Ce code fait partie d’un exemple plus large fourni pour la MethodBody classe .

C#

using System;
using System.Reflection;

public class Example
{
    public static void Main()
    {
        // Get method body information.
        MethodInfo mi = typeof(Example).GetMethod("MethodBodyExample");
        MethodBody mb = mi.GetMethodBody();
        Console.WriteLine("\r\nMethod: {0}", mi);

        // Display the general information included in the
        // MethodBody object.
        Console.WriteLine("    Local variables are initialized: {0}",
            mb.InitLocals);
        Console.WriteLine("    Maximum number of items on the operand stack: {0}",
            mb.MaxStackSize);

C#

// Display exception handling clauses.
Console.WriteLine();
foreach (ExceptionHandlingClause ehc in mb.ExceptionHandlingClauses)
{
    Console.WriteLine(ehc.Flags.ToString());

    // The FilterOffset property is meaningful only for Filter
    // clauses. The CatchType property is not meaningful for
    // Filter or Finally clauses.
    switch (ehc.Flags)
    {
        case ExceptionHandlingClauseOptions.Filter:
            Console.WriteLine("        Filter Offset: {0}",
                ehc.FilterOffset);
            break;
        case ExceptionHandlingClauseOptions.Finally:
            break;
        default:
            Console.WriteLine("    Type of exception: {0}",
                ehc.CatchType);
            break;
    }

    Console.WriteLine("       Handler Length: {0}", ehc.HandlerLength);
    Console.WriteLine("       Handler Offset: {0}", ehc.HandlerOffset);
    Console.WriteLine("     Try Block Length: {0}", ehc.TryLength);
    Console.WriteLine("     Try Block Offset: {0}", ehc.TryOffset);
}

C#

    }

    // The Main method contains code to analyze this method, using
    // the properties and methods of the MethodBody class.
    public void MethodBodyExample(object arg)
    {
        // Define some local variables. In addition to these variables,
        // the local variable list includes the variables scoped to
        // the catch clauses.
        int var1 = 42;
        string var2 = "Forty-two";

        try
        {
            // Depending on the input value, throw an ArgumentException or
            // an ArgumentNullException to test the Catch clauses.
            if (arg == null)
            {
                throw new ArgumentNullException("The argument cannot be null.");
            }
            if (arg.GetType() == typeof(string))
            {
                throw new ArgumentException("The argument cannot be a string.");
            }
        }

        // This filter clause selects only exceptions that derive
        // from the ArgumentException class.
        // Other exceptions, including ArgumentException itself,
        // are not handled by this filter clause.
        catch (ArgumentException ex) when (ex.GetType().IsSubclassOf(typeof(ArgumentException)))
        {
            Console.WriteLine("Filter clause caught: {0}", ex.GetType());
        }

        // This catch clause handles the ArgumentException class, and
        // any other class derived from Exception.
        catch(Exception ex)
        {
            Console.WriteLine("Ordinary exception-handling clause caught: {0}",
                ex.GetType());
        }
        finally
        {
            var1 = 3033;
            var2 = "Another string.";
        }
    }
}

// This code example produces output similar to the following:
//
//Method: Void MethodBodyExample(System.Object)
//    Local variables are initialized: True
//    Maximum number of items on the operand stack: 2

C#

//
//Filter
//      Filter Offset: 71
//      Handler Length: 23
//      Handler Offset: 116
//      Try Block Length: 61
//      Try Block Offset: 10
//Clause
//    Type of exception: System.Exception
//       Handler Length: 21
//       Handler Offset: 70
//     Try Block Length: 61
//     Try Block Offset: 9
//Finally
//       Handler Length: 14
//       Handler Offset: 94
//     Try Block Length: 85
//     Try Block Offset: 9

Remarques

Pour examiner les clauses de gestion des exceptions dans une méthode, obtenez un MethodInfo objet et appelez la GetMethodBody méthode pour obtenir le corps de la méthode. Utilisez la ExceptionHandlingClauses propriété pour obtenir une liste d’objets ExceptionHandlingClause .

Note

L’utilisation de clauses de gestion des exceptions nécessite une compréhension approfondie des métadonnées et des formats d’instruction MSIL (Microsoft Intermediate Language). Vous trouverez des informations dans la documentation cli (Common Language Infrastructure), en particulier « Partition II : Définition et sémantique des métadonnées ».

S’applique à

Voir aussi

• MethodBody
• ExceptionHandlingClause