Procedura: Ricevere notifiche di eccezione First-Chance

Articolo
04/04/2025

Nota

Questo articolo è specifico di .NET Framework. Non si applica alle implementazioni più recenti di .NET, incluse .NET 6 e versioni successive.

L'evento FirstChanceException della AppDomain classe consente di ricevere una notifica che informa che è stata generata un'eccezione, prima che Common Language Runtime abbia iniziato a cercare gestori di eccezioni.

L'evento viene generato a livello di dominio dell'applicazione. Un thread di esecuzione può passare attraverso più domini applicazione, pertanto un'eccezione non gestita in un dominio applicazione può essere gestita in un altro dominio applicazione. La notifica viene eseguita in ogni dominio applicativo che ha aggiunto un gestore per l'evento, fino a quando un dominio applicativo non gestisce l'eccezione.

Le procedure e gli esempi in questo articolo illustrano come ricevere notifiche di eccezione first-chance in un semplice programma con un dominio applicativo e in un dominio applicativo che crei.

Per un esempio più complesso che si estende su più domini applicazione, vedere l'esempio per l'evento FirstChanceException .

Ricezione di notifiche di eccezione First-Chance nel dominio applicazione predefinito

Nella procedura seguente, il punto di ingresso per l'applicazione, il Main() metodo , viene eseguito nel dominio applicazione predefinito.

Per illustrare le notifiche di prima eccezione rilevata nel dominio dell'applicazione predefinito

Definire un gestore eventi per l'evento FirstChanceException , usando una funzione lambda e associarlo all'evento. In questo esempio, il gestore eventi stampa il nome del dominio applicazione in cui è stato gestito l'evento e la proprietà dell'eccezione Message .

using System;
using System.Runtime.ExceptionServices;

class Example
{
    static void Main()
    {
        AppDomain.CurrentDomain.FirstChanceException +=
            (object source, FirstChanceExceptionEventArgs e) =>
            {
                Console.WriteLine($"FirstChanceException event raised in {AppDomain.CurrentDomain.FriendlyName}: {e.Exception.Message}");
            };

Imports System.Runtime.ExceptionServices

Class Example

    Shared Sub Main()

        AddHandler AppDomain.CurrentDomain.FirstChanceException,
                   Sub(source As Object, e As FirstChanceExceptionEventArgs)
                       Console.WriteLine("FirstChanceException event raised in {0}: {1}",
                                         AppDomain.CurrentDomain.FriendlyName,
                                         e.Exception.Message)
                   End Sub

Generare un'eccezione e intercettarla. Prima che il runtime individua il gestore eccezioni, l'evento FirstChanceException viene generato e visualizza un messaggio. Questo messaggio è seguito dal messaggio visualizzato dal gestore eccezioni.

try
{
    throw new ArgumentException("Thrown in " + AppDomain.CurrentDomain.FriendlyName);
}
catch (ArgumentException ex)
{
    Console.WriteLine($"ArgumentException caught in {AppDomain.CurrentDomain.FriendlyName}: {ex.Message}");
}

Try
    Throw New ArgumentException("Thrown in " & AppDomain.CurrentDomain.FriendlyName)

Catch ex As ArgumentException

    Console.WriteLine("ArgumentException caught in {0}: {1}",
        AppDomain.CurrentDomain.FriendlyName, ex.Message)
End Try

Generare un'eccezione, ma non intercettarla. Prima che il runtime cerchi un gestore eccezioni, l'evento FirstChanceException viene generato e visualizza un messaggio. Non esiste alcun gestore eccezioni, quindi l'applicazione termina.

        throw new ArgumentException("Thrown in " + AppDomain.CurrentDomain.FriendlyName);
    }
}

        Throw New ArgumentException("Thrown in " & AppDomain.CurrentDomain.FriendlyName)
    End Sub
End Class

Il codice visualizzato nei primi tre passaggi di questa procedura costituisce un'applicazione console completa. L'output dell'applicazione varia a seconda del nome del file .exe, perché il nome del dominio applicazione predefinito è costituito dal nome e dall'estensione del file .exe. Vedere quanto segue per l'output di esempio.

/* This example produces output similar to the following:

FirstChanceException event raised in Example.exe: Thrown in Example.exe
ArgumentException caught in Example.exe: Thrown in Example.exe
FirstChanceException event raised in Example.exe: Thrown in Example.exe

Unhandled Exception: System.ArgumentException: Thrown in Example.exe
   at Example.Main()
 */

' This example produces output similar to the following:
'
'FirstChanceException event raised in Example.exe: Thrown in Example.exe
'ArgumentException caught in Example.exe: Thrown in Example.exe
'FirstChanceException event raised in Example.exe: Thrown in Example.exe
'
'Unhandled Exception: System.ArgumentException: Thrown in Example.exe
'   at Example.Main()

Ricezione di notifiche di eccezione First-Chance in un altro dominio applicazione

Se il programma contiene più domini applicazione, è possibile scegliere quali domini applicazione ricevono notifiche.

Per ricevere notifiche di eccezione al primo errore in un dominio applicativo che crei

Definire un gestore eventi per l'evento FirstChanceException . In questo esempio viene utilizzato un static metodo (Shared metodo in Visual Basic) che stampa il nome del dominio applicazione in cui è stato gestito l'evento e la proprietà dell'eccezione Message .

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

Shared Sub FirstChanceHandler(ByVal source As Object,
                              ByVal e As FirstChanceExceptionEventArgs)

    Console.WriteLine("FirstChanceException event raised in {0}: {1}",
        AppDomain.CurrentDomain.FriendlyName, e.Exception.Message)
End Sub

Creare un dominio applicazione e aggiungere il gestore eventi all'evento FirstChanceException per il dominio applicazione. In questo esempio il dominio applicazione è denominato AD1.
```
AppDomain ad = AppDomain.CreateDomain("AD1");
ad.FirstChanceException += FirstChanceHandler;
```
```
Dim ad As AppDomain = AppDomain.CreateDomain("AD1")
AddHandler ad.FirstChanceException, AddressOf FirstChanceHandler
```
È possibile gestire questo evento nel dominio applicazione predefinito nello stesso modo. Utilizzare la static proprietà (Shared in Visual Basic) AppDomain.CurrentDomain in Main() per ottenere un riferimento al dominio applicazione predefinito.

Per illustrare le notifiche di eccezione di primo tentativo nel dominio dell'applicazione

Creare un Worker oggetto nel dominio applicazione creato nella procedura precedente. La Worker classe deve essere pubblica e deve derivare da MarshalByRefObject, come illustrato nell'esempio completo alla fine di questo articolo.

Worker w = (Worker) ad.CreateInstanceAndUnwrap(
                        typeof(Worker).Assembly.FullName, "Worker");

Dim w As Worker = CType(ad.CreateInstanceAndUnwrap(
                            GetType(Worker).Assembly.FullName, "Worker"),
                        Worker)

Chiamare un metodo dell'oggetto Worker che genera un'eccezione. In questo esempio il Thrower metodo viene chiamato due volte. La prima volta, l'argomento del metodo è true, il che porta il metodo a catturare la propria eccezione. La seconda volta, l'argomento è falsee il Main() metodo intercetta l'eccezione nel dominio applicazione predefinito.

// The worker throws an exception and catches it.
w.Thrower(true);

try
{
    // The worker throws an exception and doesn't catch it.
    w.Thrower(false);
}
catch (ArgumentException ex)
{
    Console.WriteLine($"ArgumentException caught in {AppDomain.CurrentDomain.FriendlyName}: {ex.Message}");
}

' The worker throws an exception and catches it.
w.Thrower(true)

Try
    ' The worker throws an exception and doesn't catch it.
    w.Thrower(false)

Catch ex As ArgumentException

    Console.WriteLine("ArgumentException caught in {0}: {1}",
        AppDomain.CurrentDomain.FriendlyName, ex.Message)
End Try

Inserire il Thrower codice nel metodo per controllare se il metodo gestisce la propria eccezione.

if (catchException)
{
    try
    {
        throw new ArgumentException("Thrown in " + AppDomain.CurrentDomain.FriendlyName);
    }
    catch (ArgumentException ex)
    {
        Console.WriteLine($"ArgumentException caught in {AppDomain.CurrentDomain.FriendlyName}: {ex.Message}");
    }
}
else
{
    throw new ArgumentException("Thrown in " + AppDomain.CurrentDomain.FriendlyName);
}

If catchException

    Try
        Throw New ArgumentException("Thrown in " & AppDomain.CurrentDomain.FriendlyName)

    Catch ex As ArgumentException

        Console.WriteLine("ArgumentException caught in {0}: {1}",
            AppDomain.CurrentDomain.FriendlyName, ex.Message)
    End Try
Else

    Throw New ArgumentException("Thrown in " & AppDomain.CurrentDomain.FriendlyName)
End If

Esempio

Nell'esempio seguente viene creato un dominio applicazione denominato AD1 e viene aggiunto un gestore eventi all'evento del dominio applicazione FirstChanceException . Nell'esempio viene creata un'istanza della classe Worker nel dominio applicativo e viene chiamata un'istanza del metodo Thrower che genera un'eccezione ArgumentException. A seconda del valore dell'argomento, il metodo intercetta l'eccezione o non riesce a gestirla.

Ogni volta che il Thrower metodo genera un'eccezione in AD1, l'evento FirstChanceException viene generato in AD1e il gestore eventi visualizza un messaggio. Il runtime cerca quindi un gestore delle eccezioni. Nel primo caso, il gestore eccezioni viene trovato in AD1. Nel secondo caso, l'eccezione non viene gestita in AD1e viene invece intercettata nel dominio applicazione predefinito.

Nota

Il nome del dominio applicazione predefinito corrisponde al nome dell'eseguibile.

Se si aggiunge un gestore per l'evento FirstChanceException al dominio applicazione predefinito, l'evento viene generato e gestito prima che il dominio applicazione predefinito gestisca l'eccezione. Per verificarlo, aggiungere il codice AppDomain.CurrentDomain.FirstChanceException += FirstChanceException; C# (in Visual Basic, AddHandler AppDomain.CurrentDomain.FirstChanceException, FirstChanceException) all'inizio di Main().

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

class Example
{
    static void Main()
    {
        // To receive first chance notifications of exceptions in
        // an application domain, handle the FirstChanceException
        // event in that application domain.
        AppDomain ad = AppDomain.CreateDomain("AD1");
        ad.FirstChanceException += FirstChanceHandler;

        // Create a worker object in the application domain.
        Worker w = (Worker) ad.CreateInstanceAndUnwrap(
                                typeof(Worker).Assembly.FullName, "Worker");

        // The worker throws an exception and catches it.
        w.Thrower(true);

        try
        {
            // The worker throws an exception and doesn't catch it.
            w.Thrower(false);
        }
        catch (ArgumentException ex)
        {
            Console.WriteLine($"ArgumentException caught in {AppDomain.CurrentDomain.FriendlyName}: {ex.Message}");
        }
    }

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

public class Worker : MarshalByRefObject
{
    public void Thrower(bool catchException)
    {
        if (catchException)
        {
            try
            {
                throw new ArgumentException("Thrown in " + AppDomain.CurrentDomain.FriendlyName);
            }
            catch (ArgumentException ex)
            {
                Console.WriteLine($"ArgumentException caught in {AppDomain.CurrentDomain.FriendlyName}: {ex.Message}");
            }
        }
        else
        {
            throw new ArgumentException("Thrown in " + AppDomain.CurrentDomain.FriendlyName);
        }
    }
}

/* This example produces output similar to the following:

FirstChanceException event raised in AD1: Thrown in AD1
ArgumentException caught in AD1: Thrown in AD1
FirstChanceException event raised in AD1: Thrown in AD1
ArgumentException caught in Example.exe: Thrown in AD1
 */

Imports System.Reflection
Imports System.Runtime.ExceptionServices

Class Example
    Shared Sub Main()

        ' To receive first chance notifications of exceptions in 
        ' an application domain, handle the FirstChanceException
        ' event in that application domain.
        Dim ad As AppDomain = AppDomain.CreateDomain("AD1")
        AddHandler ad.FirstChanceException, AddressOf FirstChanceHandler


        ' Create a worker object in the application domain.
        Dim w As Worker = CType(ad.CreateInstanceAndUnwrap(
                                    GetType(Worker).Assembly.FullName, "Worker"),
                                Worker)

        ' The worker throws an exception and catches it.
        w.Thrower(true)

        Try
            ' The worker throws an exception and doesn't catch it.
            w.Thrower(false)

        Catch ex As ArgumentException

            Console.WriteLine("ArgumentException caught in {0}: {1}",
                AppDomain.CurrentDomain.FriendlyName, ex.Message)
        End Try
    End Sub

    Shared Sub FirstChanceHandler(ByVal source As Object,
                                  ByVal e As FirstChanceExceptionEventArgs)

        Console.WriteLine("FirstChanceException event raised in {0}: {1}",
            AppDomain.CurrentDomain.FriendlyName, e.Exception.Message)
    End Sub
End Class

Public Class Worker
    Inherits MarshalByRefObject

    Public Sub Thrower(ByVal catchException As Boolean)

        If catchException

            Try
                Throw New ArgumentException("Thrown in " & AppDomain.CurrentDomain.FriendlyName)

            Catch ex As ArgumentException

                Console.WriteLine("ArgumentException caught in {0}: {1}",
                    AppDomain.CurrentDomain.FriendlyName, ex.Message)
            End Try
        Else

            Throw New ArgumentException("Thrown in " & AppDomain.CurrentDomain.FriendlyName)
        End If
    End Sub
End Class

' This example produces output similar to the following:
'
'FirstChanceException event raised in AD1: Thrown in AD1
'ArgumentException caught in AD1: Thrown in AD1
'FirstChanceException event raised in AD1: Thrown in AD1
'ArgumentException caught in Example.exe: Thrown in AD1

Vedere anche

FirstChanceException

Condividi tramite