본문 바로가기
Programming/C#

C# 이벤트 핸들러(Event Handler) 이해와 활용

by Dev_카페인 2024. 7. 11.
반응형

C# 이벤트 핸들러(Event Handler) 이해와 활용

 

안녕하세요! 오늘은 C#의 이벤트 핸들러(Event Handler)에 대해 알아보겠습니다. 이벤트 핸들러는 GUI 애플리케이션, 게임 개발, 그리고 다양한 비동기 프로그래밍 시 매우 유용하게 사용됩니다. 이번 포스트에서는 이벤트 핸들러의 기본 개념부터 구현 방법, 그리고 실제 예제까지 다루어 보겠습니다.

이벤트 핸들러란?

개념

이벤트 핸들러(Event Handler)는 특정 이벤트가 발생했을 때 실행될 메서드를 정의하는 데 사용됩니다. 이벤트는 일반적으로 사용자 입력(버튼 클릭, 키보드 입력 등), 타이머 만료, 파일 입출력 완료 등의 상황에서 발생합니다. 이벤트 핸들러는 이러한 이벤트에 대응하여 적절한 작업을 수행합니다.

구조

C#의 이벤트 핸들러는 델리게이트(delegate)와 이벤트(event) 키워드를 사용하여 구현됩니다. 델리게이트는 메서드 참조를 나타내며, 이벤트는 특정 델리게이트 타입의 인스턴스로 선언됩니다.

이벤트 핸들러의 구성 요소

1. 델리게이트

델리게이트는 특정 시그니처를 갖는 메서드를 참조하는 타입입니다. 이벤트 핸들러 델리게이트는 일반적으로 두 개의 매개변수를 갖습니다: object sender와 EventArgs e.

public delegate void EventHandler(object sender, EventArgs e);
public delegate void EventHandler<TEventArgs>(object? sender, TEventArgs e);

2. 이벤트

이벤트는 델리게이트 인스턴스로 선언되며, 이벤트가 발생할 때 호출될 메서드 목록을 관리합니다.

public event EventHandler MyEvent;

3. 이벤트 핸들러 메서드

이벤트 핸들러 메서드는 델리게이트와 일치하는 시그니처를 가져야 합니다.

void OnMyEvent(object sender, EventArgs e)
{
    Console.WriteLine("Event triggered!");
}

void OnMyEvent(object? sender, EventArgs e)
{
    Console.WriteLine("Event triggered!");
}

이벤트 핸들러 구현 예제

아래는 간단한 이벤트 핸들러 예제입니다. 이 예제에서는 버튼 클릭 이벤트를 처리합니다.

using System;

namespace EventHandlerExample
{
    // 버튼 클래스 정의
    public class Button
    {
        // 클릭 이벤트 정의
        public event EventHandler Click;

        // 클릭 메서드 구현
        public void OnClick()
        {
            // 이벤트 핸들러가 있으면 호출
            if (Click != null)
            {
                Click(this, EventArgs.Empty);
            }
        }
    }

    // 메인 프로그램 클래스
    class Program
    {
        static void Main(string[] args)
        {
            // 버튼 인스턴스 생성
            Button button = new Button();

            // 이벤트 핸들러 등록
            button.Click += Button_Click;

            // 버튼 클릭 메서드 호출
            button.OnClick();
        }

        // 이벤트 핸들러 메서드 정의
        private static void Button_Click(object sender, EventArgs e)
        {
            Console.WriteLine("Button clicked!");
        }
    }
}

코드 설명

1. 버튼 클래스 정의

Button 클래스는 Click 이벤트를 정의하고, OnClick 메서드를 통해 이벤트를 발생시킵니다. OnClick 메서드는 이벤트 핸들러가 등록되어 있는지 확인하고, 등록되어 있다면 이를 호출합니다.

2. 메인 프로그램 클래스

Program 클래스에서 Button 인스턴스를 생성하고, Click 이벤트에 Button_Click 메서드를 이벤트 핸들러로 등록합니다. 이후 OnClick 메서드를 호출하여 이벤트를 트리거합니다.

고급 이벤트 핸들링

1. 이벤트 데이터 전달

이벤트 핸들러에 추가 데이터를 전달하려면 EventArgs를 상속받아 커스텀 이벤트 데이터 클래스를 만들 수 있습니다.

// 커스텀 이벤트 데이터 클래스 정의
public class CustomEventArgs : EventArgs
{
    public string Message { get; }

    public CustomEventArgs(string message)
    {
        Message = message;
    }
}

2. 커스텀 이벤트 핸들러 델리게이트

커스텀 이벤트 데이터를 사용하려면 해당 타입을 사용하는 델리게이트를 정의합니다.

public delegate void CustomEventHandler(object sender, CustomEventArgs e);

3. 이벤트 구현 및 사용

커스텀 이벤트 데이터를 사용하는 이벤트를 구현하고 사용하는 예제입니다.

using System;

namespace CustomEventHandlerExample
{
    // 버튼 클래스 정의
    public class Button
    {
        // 커스텀 이벤트 정의
        public event CustomEventHandler Click;

        // 클릭 메서드 구현
        public void OnClick()
        {
            if (Click != null)
            {
                Click(this, new CustomEventArgs("Button clicked with custom event data!"));
            }
        }
    }

    // 메인 프로그램 클래스
    class Program
    {
        static void Main(string[] args)
        {
            // 버튼 인스턴스 생성
            Button button = new Button();

            // 커스텀 이벤트 핸들러 등록
            button.Click += Button_Click;

            // 버튼 클릭 메서드 호출
            button.OnClick();
        }

        // 커스텀 이벤트 핸들러 메서드 정의
        private static void Button_Click(object sender, CustomEventArgs e)
        {
            Console.WriteLine(e.Message);
        }
    }
}

결론

이벤트 핸들러는 C#에서 매우 중요한 개념으로, 다양한 비동기 작업과 사용자 인터페이스 이벤트 처리에 필수적입니다. 기본 개념부터 커스텀 이벤트 데이터까지 다양한 예제를 통해 이벤트 핸들러의 활용 방법을 익혔습니다. 이 포스트가 여러분의 C# 프로그래밍 실력을 향상시키는 데 도움이 되길 바랍니다.

 

 

더보기

이 문서에서는 다음 컴파일러 경고에 대해 설명합니다.

CS8597 - throw된 값은 null일 수 있습니다.
CS8600 - null 리터럴 또는 가능한 null 값을 null을 허용하지 않는 형식으로 변환합니다.
CS8601 - 가능한 null 참조 할당입니다.
CS8602 - 가능한 null 참조의 역참조.
CS8603 - 가능한 null 참조 반환입니다.
CS8604 - 매개 변수에 대한 가능한 null 참조 인수입니다.
CS8605 - 가능한 null 값을 unboxing합니다.
CS8607 - 가능한 null 값은 [NotNull] 또는 [DisallowNull]로 표시된 형식에 사용할 수 없습니다.
CS8608 - 형식에 있는 참조 형식의 Null 허용 여부가 재정의된 멤버와 일치하지 않습니다.
CS8609 - 반환 형식에서 참조 형식의 Null 허용 여부가 재정의된 멤버와 일치하지 않습니다.
CS8610 - 형식 매개 변수에 있는 참조 형식의 Null 허용 여부가 재정의된 멤버와 일치하지 않습니다.
CS8611 - 형식 매개 변수에 있는 참조 형식의 Null 허용 여부가 부분 메서드 선언과 일치하지 않습니다.
CS8612 - 형식에 있는 참조 형식의 Null 허용 여부가 암시적으로 구현된 멤버와 일치하지 않습니다.
CS8613 - 반환 형식에서 참조 형식의 Null 허용 여부가 암시적으로 구현된 멤버와 일치하지 않습니다.
CS8614 - 매개 변수 형식의 참조 형식 Null 허용 여부가 암시적으로 구현된 멤버와 일치하지 않습니다.
CS8615 - 형식에 있는 참조 형식의 Null 허용 여부가 구현된 멤버와 일치하지 않습니다.
CS8616 - 반환 형식에 있는 참조 형식의 Null 허용 여부가 구현된 멤버와 일치하지 않습니다.
CS8617 - 매개 변수 형식의 참조 형식 Null 허용 여부가 구현된 멤버와 일치하지 않습니다.
CS8618 - null을 허용하지 않는 변수는 생성자를 종료할 때 null이 아닌 값을 포함해야 합니다. null 허용으로 선언하는 것이 좋습니다.
CS8619 - 값의 참조 형식 Null 허용 여부가 대상 유형과 일치하지 않습니다.
CS8620 - 참조 형식의 Null 허용 여부가 다르기 때문에 매개 변수에 인수를 사용할 수 없습니다.
CS8621 - 반환 형식에 있는 참조 형식의 Null 허용 여부가 대상 대리자와 일치하지 않습니다(Null 허용 여부 특성 때문일 수 있음).
CS8622 - 매개 변수 형식에서 참조 형식의 Null 허용 여부가 대상 대리자와 일치하지 않습니다(Null 허용 여부 특성 때문일 수 있음).
CS8624 - 참조 형식의 Null 허용 여부가 다르기 때문에 인수를 출력으로 사용할 수 없습니다.
CS8625 - null 리터럴을 null을 허용하지 않는 참조 형식으로 변환할 수 없습니다.
CS8629 - Null 허용 값 형식은 null일 수 있습니다.
CS8631 - 제네릭 형식 또는 메서드에서 형식을 형식 매개 변수로 사용할 수 없습니다. 형식 인수의 Null 허용 여부가 제약 조건 형식과 일치하지 않습니다.
CS8633 - 메서드 형식 매개 변수 제약 조건의 Null 허용 여부가 인터페이스 메서드 형식 매개 변수 제약 조건과 일치하지 않습니다. 명시적 인터페이스 구현을 대신 사용하세요.
CS8634 - 이 형식은 제네릭 형식 또는 메서드에서 형식 매개 변수로 사용할 수 없습니다. 형식 인수의 Null 허용 여부가 '클래스' 제약 조건과 일치하지 않습니다.
CS8643 - 명시적 인터페이스 지정자에 있는 참조 형식의 Null 허용 여부가 해당 형식으로 구현된 인터페이스와 일치하지 않습니다.
CS8644 - 형식이 인터페이스 멤버를 구현하지 않습니다. 기본 형식으로 구현된 인터페이스의 참조 형식의 Null 허용 여부가 일치하지 않습니다.
CS8645 - 참조 형식의 Null 허용 여부가 다른 형식의 인터페이스 목록에 멤버가 이미 나열되어 있습니다.
CS8655 - switch 식은 일부 null 입력을 처리하지 않습니다(완전하지는 않음).
CS8667 - 부분 메서드 선언의 형식 매개 변수 제약 조건에 일관되지 않은 Null 허용 여부가 있습니다.
CS8670 - 개체 또는 컬렉션 이니셜라이저가 null일 수 있는 멤버를 암시적으로 역참조합니다.
CS8714 - 이 형식은 제네릭 형식 또는 메서드에서 형식 매개 변수로 사용할 수 없습니다. 형식 인수의 Null 허용 여부가 'notnull' 제약 조건과 일치하지 않습니다.
CS8762 - 종료 시 매개 변수에 null이 아닌 값이 있어야 합니다.
CS8763 - [DoesNotReturn]으로 표시된 메서드는 반환되어서는 안 됩니다.
CS8764 - 반환 형식의 Null 허용 여부가 재정의된 멤버와 일치하지 않습니다(Null 허용 여부 특성 때문일 수 있음).
CS8765 - 매개 변수 형식의 Null 허용 여부가 재정의된 멤버와 일치하지 않습니다(Null 허용 여부 특성 때문일 수 있음).
CS8766 - 반환 형식에 있는 참조 형식의 Null 허용 여부가 암시적으로 구현된 멤버와 일치하지 않습니다(Null 허용 여부 특성 때문일 수 있음).
CS8767 - 매개 변수 형식의 참조 형식의 Null 허용 여부가 암시적으로 구현된 멤버와 일치하지 않습니다(Null 허용 여부 특성 때문일 수 있음).
CS8768 - 반환 형식에 있는 참조 형식의 Null 허용 여부가 구현된 멤버와 일치하지 않습니다(Null 허용 여부 특성 때문일 수 있음).
CS8769 - 매개 변수 형식의 참조 형식의 Null 허용 여부가 구현된 멤버와 일치하지 않습니다(Null 허용 여부 특성 때문일 수 있음).
CS8770 - 메서드에 구현되거나 재정의된 멤버와 일치하는 [DoesNotReturn] 주석이 없습니다.
CS8774 - 멤버 종료 시 null이 아닌 값이 있어야 합니다.
CS8776 - 이 특성에서는 멤버를 사용할 수 없습니다.
CS8775 - 멤버 종료 시 null이 아닌 값이 있어야 합니다.
CS8777 - 종료 시 매개 변수에 null이 아닌 값이 있어야 합니다.
CS8819 - 반환 형식에서 참조 형식의 Null 허용 여부가 부분 메서드 선언과 일치하지 않습니다.
CS8824 - 매개 변수가 null이 아니기 때문에 종료 시 매개 변수에 null이 아닌 값이 있어야 합니다.
CS8825 - 매개 변수가 null이 아니기 때문에 반환 값은 null이 아니어야 합니다.
CS8847 - switch 식은 일부 null 입력을 처리하지 않습니다(전체 아님). 그러나 'when' 절이 있는 패턴은 이 값과 성공적으로 일치할 수 있습니다.

https://learn.microsoft.com/ko-kr/dotnet/csharp/language-reference/compiler-messages/nullable-warnings

 

Nullable 경고 해결 - C# reference

여러 컴파일러 경고는 Null 안전이 아닌 코드를 나타냅니다. 코드의 복원력을 높여 이러한 경고를 해결하는 방법을 알아봅니다.

learn.microsoft.com

 

반응형