C# 事件模式入門：Delegate、Event 與 Handler 實作範例

C# 的事件模式建立在 Delegate (委派) 之上，實現「發佈-訂閱」模式。本文以最精簡的程式碼示範如何宣告委派、定義事件、引發事件與訂閱處理。

核心程式碼解析

using System;

public class EventDemo
{
    // 1. 定義委派型別：簽名為 (object sender, EventArgs e)
    public delegate void ActionEventHandler(object sender, EventArgs e);

    // 2. 宣告事件 (以 delegate 型別為型別)
    public static event ActionEventHandler Action;

    // 3. 受保護的虛擬方法：負責引發事件 (命名慣例 On + 事件名)
    protected virtual void OnAction(object sender, EventArgs e)
    {
        // 使用 ?. 呼叫避免 null 參考 (C# 6+)
        Action?.Invoke(sender, e);
    }

    // 4. 事件處理方法 (符合委派簽名)
    public void HandlerA(object sender, EventArgs e)
    {
        Console.WriteLine("HandlerA 執行：" + DateTime.Now);
    }

    // 5. 訂閱與觸發示範
    public void Demo()
    {
        // 訂閱
        Action += new ActionEventHandler(HandlerA);
        // 或簡寫：Action += HandlerA;

        // 觸發
        OnAction(this, EventArgs.Empty);

        // 取消訂閱
        Action -= HandlerA;
    }
}

關鍵觀念釐清

進階：自訂 EventArgs 傳遞資料

public class PriceChangedEventArgs : EventArgs
{
    public decimal OldPrice { get; }
    public decimal NewPrice { get; }
    public PriceChangedEventArgs(decimal oldPrice, decimal newPrice)
    {
        OldPrice = oldPrice; NewPrice = newPrice;
    }
}

public class Stock
{
    public event EventHandler<PriceChangedEventArgs> PriceChanged;
    private decimal _price;
    public decimal Price
    {
        get => _price;
        set
        {
            if (_price != value)
            {
                var args = new PriceChangedEventArgs(_price, value);
                _price = value;
                PriceChanged?.Invoke(this, args);
            }
        }
    }
}

最佳實務摘要

• 事件命名用動詞過去分詞：Clicked、PriceChanged、Completed。
• 引發方法標記 protected virtual 方便衍生類別覆寫。
• 使用 EventHandler<TEventArgs> 泛型委派，免自訂 delegate 型別。
• 多執行緒環境下，複製事件委派再呼叫以避免競態：var handler = Action; handler?.Invoke(...);