방법: First-Chance 예외 알림 받기

아티클
03/25/2025

비고

이 문서는 .NET Framework에만 적용됩니다. .NET 6 이상 버전을 포함하여 .NET의 최신 구현에는 적용되지 않습니다.

AppDomain 클래스의 FirstChanceException 이벤트를 사용하면 공용 언어 런타임에서 예외 처리기 검색을 시작하기 전에 예외가 throw되었다는 알림을 받을 수 있습니다.

이 이벤트는 애플리케이션 도메인 수준에서 발생합니다. 실행 스레드는 여러 애플리케이션 도메인을 통과할 수 있으므로 한 애플리케이션 도메인에서 처리되지 않은 예외는 다른 애플리케이션 도메인에서 처리될 수 있습니다. 알림은 애플리케이션 도메인이 예외를 처리할 때까지 이벤트에 대한 처리기를 추가한 각 애플리케이션 도메인에서 발생합니다.

이 문서의 절차 및 예제는 하나의 애플리케이션 도메인이 있는 간단한 프로그램 및 사용자가 만든 애플리케이션 도메인에서 첫 번째 예외 알림을 받는 방법을 보여 줍니다.

여러 애플리케이션 도메인에 걸쳐 있는 더 복잡한 예제는 FirstChanceException 이벤트에 대한 예제를 참조하세요.

기본 애플리케이션 도메인에서 First-Chance 예외 알림 수신

다음 절차에서 애플리케이션의 진입점인 Main() 메서드는 기본 애플리케이션 도메인에서 실행됩니다.

기본 애플리케이션 도메인에서 첫 번째 예외 알림을 보여 주려면

람다 함수를 사용하여 FirstChanceException 이벤트에 대한 이벤트 처리기를 정의하고 이벤트에 연결합니다. 이 예제에서 이벤트 처리기는 이벤트가 처리된 애플리케이션 도메인의 이름과 예외의 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

예외를 던지고 잡습니다. 런타임에서 예외 처리기를 찾기 전에 FirstChanceException 이벤트가 발생하고 메시지를 표시합니다. 이 메시지 뒤에는 예외 처리기가 표시하는 메시지가 표시됩니다.

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

예외를 던지고, 잡지 마세요. 런타임에서 예외 처리기를 검색하기 전에 FirstChanceException 이벤트가 발생하고 메시지를 표시합니다. 예외 처리기는 없으므로 애플리케이션이 종료됩니다.

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

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

이 절차의 처음 세 단계에 표시된 코드는 전체 콘솔 애플리케이션을 형성합니다. 기본 애플리케이션 도메인의 이름은 .exe 파일의 이름 및 확장명으로 구성되므로 애플리케이션의 출력은 .exe 파일의 이름에 따라 달라집니다. 샘플 출력은 다음을 참조하세요.

/* 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()

다른 애플리케이션 도메인에서 First-Chance 예외 알림 받기

프로그램에 둘 이상의 애플리케이션 도메인이 포함된 경우 알림을 받는 애플리케이션 도메인을 선택할 수 있습니다.

만든 애플리케이션 도메인에서 첫 번째 예외 알림을 받으려면

FirstChanceException 이벤트에 대한 이벤트 처리기를 정의합니다. 이 예제에서는 이벤트가 처리된 애플리케이션 도메인의 이름과 예외의 Message 속성을 출력하는 static 메서드(Visual Basic의Shared 메서드)를 사용합니다.

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

애플리케이션 도메인을 만들고 해당 애플리케이션 도메인에 대한 FirstChanceException 이벤트에 이벤트 처리기를 추가합니다. 이 예제에서 애플리케이션 도메인의 이름은 AD1.
```
AppDomain ad = AppDomain.CreateDomain("AD1");
ad.FirstChanceException += FirstChanceHandler;
```
```
Dim ad As AppDomain = AppDomain.CreateDomain("AD1")
AddHandler ad.FirstChanceException, AddressOf FirstChanceHandler
```
동일한 방식으로 기본 애플리케이션 도메인에서 이 이벤트를 처리할 수 있습니다. Main() static(Visual Basic의Shared) AppDomain.CurrentDomain 속성을 사용하여 기본 애플리케이션 도메인에 대한 참조를 가져옵니다.

애플리케이션 도메인에서의 첫 번째 기회 예외 알림을 보여주려면

이전 절차에서 만든 애플리케이션 도메인에 Worker 개체를 만듭니다. Worker 클래스는 공용이어야 하며 이 문서의 끝에 있는 전체 예제와 같이 MarshalByRefObject파생되어야 합니다.

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

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

Worker 개체의 예외를 발생시키는 메서드를 호출합니다. 이 예제에서는 Thrower 메서드를 두 번 호출합니다. 처음에는 메서드 인수가 true이어서, 이로 인해 메서드가 자체 예외를 포착합니다. 두 번째로 인수는 false이고, 기본 애플리케이션 도메인에서 Main() 메서드가 예외를 처리합니다.

// 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

Thrower 메서드에 코드를 배치하여 메서드가 자체 예외를 처리하는지 여부를 제어합니다.

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

예시

다음 예제에서는 AD1 라는 애플리케이션 도메인을 만들고 애플리케이션 도메인의 FirstChanceException 이벤트에 이벤트 처리기를 추가 합니다. 이 예제는 애플리케이션 도메인에서 Worker 클래스의 인스턴스를 생성하고, ArgumentException를 throw하는 Thrower 메서드를 호출합니다. 인수의 값에 따라 메서드는 예외를 catch하거나 처리하지 못합니다.

Thrower 메서드가 AD1에서 예외를 던질 때마다 AD1에서 FirstChanceException 이벤트가 발생하며, 이벤트 처리기가 메시지를 표시합니다. 그런 다음 런타임에서 예외 처리기를 찾습니다. 첫 번째 경우, 예외 처리기는 AD1에서 발견됩니다. 두 번째 경우에, 예외는 AD1에서 처리되지 않고 대신 기본 애플리케이션 도메인에서 포착됩니다.

비고

기본 애플리케이션 도메인의 이름은 실행 파일의 이름과 같습니다.

FirstChanceException 이벤트에 대한 처리기를 기본 애플리케이션 도메인에 추가하면 기본 애플리케이션 도메인이 예외를 처리하기 전에 이벤트가 발생하고 처리됩니다. 이를 확인하려면 Main()시작 부분에 C# 코드 AppDomain.CurrentDomain.FirstChanceException += FirstChanceException;(Visual Basic, AddHandler AppDomain.CurrentDomain.FirstChanceException, FirstChanceException)를 추가합니다.

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

참고하십시오

FirstChanceException

다음을 통해 공유