FirstChanceExceptionEventArgs Classe

Définition

Espace de noms:

System.Runtime.ExceptionServices

Assembly:

System.Runtime.dll

Source:

FirstChanceExceptionEventArgs.cs

Fournit des données pour l'événement de notification qui se déclenche lorsqu'une exception managée se produit pour la première fois, avant que le Common Language Runtime ne commence à rechercher des gestionnaires d'événements.

C#

public class FirstChanceExceptionEventArgs : EventArgs

Héritage

Object

EventArgs

FirstChanceExceptionEventArgs

Exemples

L’exemple suivant crée une série de domaines d’application nommées Child_0 via Child_3, avec un Worker objet dans chaque domaine d’application. Chaque Worker objet a une référence à l’objet Worker dans le domaine d’application suivant, à l’exception de dans le Worker dernier domaine d’application. L’événement FirstChanceException est géré dans tous les domaines d’application à l’exception Child_1de .

Une fois les domaines d’application créés, le domaine d’application par défaut appelle la TestException méthode pour le premier domaine d’application enfant. Chaque Worker objet appelle la TestException méthode pour le suivant, jusqu’à ce que le dernier Worker lève une exception gérée ou non gérée. Ainsi, le thread actuel passe par tous les domaines d’application et TestException est ajouté à la pile dans chaque domaine d’application.

Lorsque le dernier Worker objet gère l’exception, l’événement FirstChanceException est déclenché uniquement dans le dernier domaine d’application. Les autres domaines d’application n’ont jamais la possibilité de gérer l’exception, de sorte que l’événement n’est pas déclenché.

Lorsque le dernier Worker objet ne gère pas l’exception, l’événement FirstChanceException est déclenché dans chaque domaine d’application qui a un gestionnaire d’événements. Une fois chaque gestionnaire d’événements terminé, la pile continue de se dérouler jusqu’à ce que l’exception soit interceptée par le domaine d’application par défaut.

Note

Pour voir comment l’affichage de la pile augmente à mesure que l’événement est déclenché de plus en plus près du domaine d’application par défaut, remplacez e.Exception.Message par e.Exception dans les FirstChanceHandler gestionnaires d’événements. Notez que lorsque TestException est appelé au-delà des limites du domaine d’application, il apparaît deux fois : une fois pour le proxy et une fois pour le stub.

C#

using System;
using System.Reflection;
using System.Runtime.ExceptionServices;

class FirstChanceExceptionSnippet
{
    static void Main()
    {
        AppDomain.CurrentDomain.FirstChanceException += FirstChanceHandler;

        // Create a set of application domains, with a Worker object in each one.
        // Each Worker object creates the next application domain.
        AppDomain ad = AppDomain.CreateDomain("AD0");
        Worker w = (Worker) ad.CreateInstanceAndUnwrap(
                                typeof(Worker).Assembly.FullName, "Worker");
        w.Initialize(0, 3);

        Console.WriteLine("\r\nThe last application domain throws an exception and catches it:");
        Console.WriteLine();
        w.TestException(true);

        try
        {
            Console.WriteLine(
                "\r\nThe last application domain throws an exception and does not catch it:");
            Console.WriteLine();
            w.TestException(false);
        }
        catch (ArgumentException ex)
        {
            Console.WriteLine("ArgumentException caught in {0}: {1}",
                AppDomain.CurrentDomain.FriendlyName, ex.Message);
        }
    }

    static void FirstChanceHandler(object source, FirstChanceExceptionEventArgs e)
    {
        Console.WriteLine("FirstChanceException event raised in {0}: {1}",
            AppDomain.CurrentDomain.FriendlyName, e.Exception.Message);
    }
}

public class Worker : MarshalByRefObject
{
    private AppDomain ad = null;
    private Worker w = null;

    public void Initialize(int count, int max)
    {
        // Handle the FirstChanceException event in all application domains except
        // AD1.
        if (count != 1)
        {
            AppDomain.CurrentDomain.FirstChanceException += FirstChanceHandler;
        }

        // Create another application domain, until the maximum is reached.
        // Field w remains null in the last application domain, as a signal
        // to TestException().
        if (count < max)
        {
            int next = count + 1;
            ad = AppDomain.CreateDomain("AD" + next);
            w = (Worker) ad.CreateInstanceAndUnwrap(
                             typeof(Worker).Assembly.FullName, "Worker");
            w.Initialize(next, max);
        }
    }

    public void TestException(bool handled)
    {
        // As long as there is another application domain, call TestException() on
        // its Worker object. When the last application domain is reached, throw a
        // handled or unhandled exception.
        if (w != null)
        {
            w.TestException(handled);
        }
        else if (handled)
        {
            try
            {
                throw new ArgumentException("Thrown in " + AppDomain.CurrentDomain.FriendlyName);
            }
            catch (ArgumentException ex)
            {
                Console.WriteLine("ArgumentException caught in {0}: {1}",
                    AppDomain.CurrentDomain.FriendlyName, ex.Message);
            }
        }
        else
        {
            throw new ArgumentException("Thrown in " + AppDomain.CurrentDomain.FriendlyName);
        }
    }

    static void FirstChanceHandler(object source, FirstChanceExceptionEventArgs e)
    {
        Console.WriteLine("FirstChanceException event raised in {0}: {1}",
            AppDomain.CurrentDomain.FriendlyName, e.Exception.Message);
    }
}

/* This example produces output similar to the following:

The last application domain throws an exception and catches it:

FirstChanceException event raised in AD3: Thrown in AD3
ArgumentException caught in AD3: Thrown in AD3

The last application domain throws an exception and does not catch it:

FirstChanceException event raised in AD3: Thrown in AD3
FirstChanceException event raised in AD2: Thrown in AD3
FirstChanceException event raised in AD0: Thrown in AD3
FirstChanceException event raised in Example.exe: Thrown in AD3
ArgumentException caught in Example.exe: Thrown in AD3
 */

Remarques

Cette classe fournit le gestionnaire d’exceptions pour l’événement AppDomain.FirstChanceException avec accès à l’exception.

Constructeurs

FirstChanceExceptionEventArgs(Exception)

Initialise une nouvelle instance de la classe FirstChanceExceptionEventArgs avec l'exception spécifiée.

Propriétés

Exception

Objet exception managé qui correspond à l'exception levée en code managé.

Méthodes

Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

S’applique à

Voir aussi

• FirstChanceException