C#事件（Event）學習日記

時間 2019-11-12

標籤 c# 事件 event 學習日記欄目 C# 简体版

原文原文鏈接

event 關鍵字的來由，爲了簡化自定義方法的構建來爲委託調用列表增長和刪除方法。html

在編譯器處理 event 關鍵字的時候，它會自動提供註冊和註銷方法以及任何須要的委託類型成員變量。架構

這些委託成員變量老是聲明爲私有的，所以不能直接從觸發事件對象訪問它們。框架

舒適提示：若是您對於委託不是很瞭解，您能夠先看 C#委託（Delegate），這對您理解本章會有所幫助。函數

定義一個事件的步驟：學習

須要定義一個委託，它包含事件觸發時將要調用方法
經過 event 關鍵字用相關委託聲明這個事件

話很少說，咱們來看一個示例：this

1. 定義Car類：spa

public class Car
{
    // 這個委託用來與Car事件協做
    public delegate void CarEngineHandler(string msg);

　　// 這種汽車能夠發送這些事件
    public event CarEngineHandler Exploded;
    public event CarEngineHandler AboutToBlow;

    public int CurrentSpeed { get; set; }

    public int MaxSpeed { get; set; }

    public string PetName { get; set; }

    private bool CarIsDead;

    public Car()
    {
        MaxSpeed = 100;
    }

    public Car(string name, int maxSp, int currSp)
    {
        CurrentSpeed = currSp;
        MaxSpeed = maxSp;
        PetName = name;
    }

    public void Accelerate(int delta)
    {
        // 若是Car沒法使用了，觸發Exploded事件
        if (CarIsDead)
        {
            if (Exploded != null)
            {
                Exploded("sorry,this car is dead");
            }
        }
        else
        {
            CurrentSpeed += delta;

            // 確認已沒法使用，觸發AboutToBlow事件
            if ((MaxSpeed - CurrentSpeed) == 10 && AboutToBlow != null)
            {
                AboutToBlow("careful buddy ! gonna blow !");
            }

            if (CurrentSpeed >= MaxSpeed)
            {
                CarIsDead = true;
            }
            else
            {
                Console.WriteLine($"CurrentSpeed={CurrentSpeed}");
            }
        }
    }
}

以上咱們已經設定了Car對象發送兩個自定義事件，這再也不須要自定義註冊函數，也不須要聲明委託成員變量。稍後咱們將說到如何使用這個汽車，在此以前，讓咱們瞭解一下事件的架構，揭開事件的神祕面紗。3d

2. 事件神祕面紗code

C#事件事實上會擴展兩個隱藏的公共方法，一個 add_事件名稱，一個 remove_事件名稱。htm

add_Exploded() CIL指令

remove_Exploded() CIL指令

表明事件自己的CIL代碼使用 .addon 和 .removeon 指令調用對應的 add_xxx() 和 remove_xxx()方法

3. 使用Car類

瞭解了這些以後，咱們來使用以前定義的Car類：

public class MyEvent
{
    public static void Show()
    {
        WriteLine("fun with events");
        Car c1 = new Car("bwm", 100, 10);

        // 註冊事件處理程序
        c1.AboutToBlow += new Car.CarEngineHandler(CarIsAlomostDoomed);
        c1.AboutToBlow += new Car.CarEngineHandler(CarAboutToBlow);

        Car.CarEngineHandler d = new Car.CarEngineHandler(CarExploded);
        c1.Exploded += d;

        WriteLine("******Speeding up******");
        for (int i = 0; i < 6; i++)
        {
            c1.Accelerate(20);
        }

        // 註銷，從調用列表中移除CarExploded()方法
        c1.Exploded -= d;

        WriteLine("******Speeding up******");
        for (int i = 0; i < 6; i++)
        {
            c1.Accelerate(20);
        }
    }
    private static void CarExploded(string msg) => WriteLine($"CarExploded-> {msg}");

    private static void CarAboutToBlow(string msg) => WriteLine($"CarAboutToBlow=>{msg}");

    private static void CarIsAlomostDoomed(string msg) => WriteLine($"CarIsAlomostDoomed-> {msg}");
}

運行效果圖：

爲了進一步簡化事件註冊，咱們能夠用到委託章節學習到的方法組轉換語法（解釋：我能夠在調用以委託做爲參數的方法時，直接提供方法的名稱，而不是委託對象）

下面請看使用方法組轉換，註冊和註銷事件，粗體部分：

public static void Show()
{
    WriteLine("fun with events");
    Car c1 = new Car("bwm", 100, 10);

    // 註冊事件處理程序
    c1.AboutToBlow += CarIsAlomostDoomed; c1.AboutToBlow += CarAboutToBlow; c1.Exploded += CarExploded; 
    WriteLine("******Speeding up******");
    for (int i = 0; i < 6; i++)
    {
        c1.Accelerate(20);
    }

    // 註銷，從調用列表中移除CarExploded()方法
    c1.Exploded -= CarExploded; 
    WriteLine("******Speeding up******");
    for (int i = 0; i < 6; i++)
    {
        c1.Accelerate(20);
    }
}

4. 建立自定義事件參數

微軟的事件模式：（System.Object sender,System.EventArgs args）這一兩個參數的模型。

第一個參數 sender ：表示一個對發送事件的對象（Car）的引用，

第二個參數 args ：與該事件相關的信息

System.EventArgs 基類源代碼：

public class EventArgs {
    public static readonly EventArgs Empty = new EventArgs();
    
    public EventArgs() 
    {
    }
}

那麼對於簡單的事件類型來講，咱們能夠直接傳遞一個EventArgs的實例，可是若是咱們指望傳遞自定義的數據，就應該從System.EventArgs派生出一個子類。
咱們接下來就爲咱們的 Car 自定義一個符合這種事件模式的事件參數，新建一個 CarEventArgs 類，包含一個字符串，表示要發送給接收者的信息：

public class CarEventArgs : EventArgs
{
    public readonly string msg;
    public CarEventArgs(string message)
    {
        msg = message;
    }
}

咱們修改一下Car類，新添加一個 CarCustomEngineHandler 委託，而且更改相應的事件代碼：

public class Car
{
    public delegate void CarCustomEngineHandler(object sender, CarEventArgs e);

    // 模仿微軟正規（object sender, EventArgs e）寫法
    public event CarCustomEngineHandler CustomExploded;
    public event CarCustomEngineHandler CustomAboutToBlow;

    public void AccelerateCustom(int delta)
    {
        if (CarIsDead)
        {
            if (CustomExploded != null)
            {
                CustomExploded(this, new CarEventArgs("sorry,this car is dead"));
            }
        }
        else
        {
            CurrentSpeed += delta;

            if ((MaxSpeed - CurrentSpeed) == 10 && CustomAboutToBlow != null)
            {
                CustomAboutToBlow(this, new CarEventArgs("careful buddy ! gonna blow !"));
            }

            if (CurrentSpeed >= MaxSpeed)
            {
                CarIsDead = true;
            }
            else
            {
                Console.WriteLine($"CurrentSpeed={CurrentSpeed}");
            }
        }
    }
}

看一下調用粗體部分（是如何使用傳遞的參數sender，e的）：

public class MyCustomEvents
{
    public static void Show()
    {
        WriteLine("fun with events");
        Car c1 = new Car("bwm", 100, 10);

        c1.CustomAboutToBlow += CarIsAlomostDoomed;
        c1.CustomAboutToBlow += CarAboutToBlow;

        Car.CarCustomEngineHandler d = CarExploded;
        c1.CustomExploded += d;

        WriteLine("******Speeding up******");
        for (int i = 0; i < 6; i++)
        {
            c1.AccelerateCustom(20);
        }

        c1.CustomExploded -= d;

        WriteLine("******Speeding up******");
        for (int i = 0; i < 6; i++)
        {
            c1.AccelerateCustom(20);
        }
    }

    private static void CarExploded(object sender, CarEventArgs e) => WriteLine($"CarExploded->{((Car)sender)?.PetName} {e.msg}"); private static void CarAboutToBlow(object sender, CarEventArgs e) => WriteLine($"CarAboutToBlow=>{((Car)sender)?.PetName} {e.msg}"); private static void CarIsAlomostDoomed(object sender, CarEventArgs e) => WriteLine($"CarIsAlomostDoomed->{((Car)sender)?.PetName} {e.msg}"); }

5. 泛型 EventHandler<T> 委託

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

因爲不少自定義委託接受（object，EventArgs）這樣的參數結構，那麼咱們能夠使用框架內置的 EventHandler<> 來簡化咱們的事件委託。

首先修改一下Car類：

public class Car
{
    public event EventHandler<CarEventArgs> StandardExploded;
    public event EventHandler<CarEventArgs> StandardAboutToBlow;

    public void AccelerateStandard(int delta)
    {
        if (CarIsDead)
        {
            if (StandardExploded != null)
            {
                StandardExploded(this, new CarEventArgs("sorry,this car is dead"));
            }
        }
        else
        {
            CurrentSpeed += delta;

            if ((MaxSpeed - CurrentSpeed) == 10 && StandardAboutToBlow != null)
            {
                StandardAboutToBlow(this, new CarEventArgs("careful buddy ! gonna blow !"));
            }

            if (CurrentSpeed >= MaxSpeed)
            {
                CarIsDead = true;
            }
            else
            {
                Console.WriteLine($"CurrentSpeed={CurrentSpeed}");
            }
        }
    }
}

調用代碼其實和上一段並無太大差別,這裏仍是貼出來：

public class MyStandardEvent
{
    public static void Show()
    {
        WriteLine("fun with events");
        Car c1 = new Car("bwm", 100, 10);

        c1.StandardAboutToBlow += CarIsAlomostDoomed;
        c1.StandardAboutToBlow += CarAboutToBlow;

        EventHandler<CarEventArgs> d = CarExploded;         c1.StandardExploded += d;

        WriteLine("******Speeding up******");
        for (int i = 0; i < 6; i++)
        {
            c1.AccelerateStandard(20);
        }

        c1.StandardExploded -= d;

        WriteLine("******Speeding up******");
        for (int i = 0; i < 6; i++)
        {
            c1.AccelerateStandard(20);
        }
    }

    private static void CarExploded(object sender, CarEventArgs e) => WriteLine($"CarExploded->{((Car)sender)?.PetName} {e.msg}");

    private static void CarAboutToBlow(object sender, CarEventArgs e) => WriteLine($"CarAboutToBlow=>{((Car)sender)?.PetName} {e.msg}");

    private static void CarIsAlomostDoomed(object sender, CarEventArgs e) => WriteLine($"CarIsAlomostDoomed->{((Car)sender)?.PetName} {e.msg}");
}

6.匿名方法

這麼簡單的處理操做， CarExploded() ，CarAboutToBlow()這一的方法不多會被調用委託以外的任何程序所調用。從生成效率來講，手工定義一個由委託對象調用的方法有點麻煩耶。

爲了解決這種狀況，如今事件註冊時，能夠直接將一個委託與一段代碼關聯 -- 匿名方法。

咱們修改一下調用Car類的地方（注意粗體部分、最後一個大括號 ";" 結束）：

public class MyAnonymousMtehoden
{
    public static void Show()
    {
        int aboutToBlowCounter = 0;

        WriteLine("fun with events");
        Car c1 = new Car("bwm", 100, 10);

        c1.StandardAboutToBlow += delegate
        {
            WriteLine("Eek,going to fast");
        };

        c1.StandardAboutToBlow += delegate (object sender, CarEventArgs e)
        {
            aboutToBlowCounter++;
            WriteLine($"CarAboutToBlow=>{((Car)sender)?.PetName} {e.msg}");
        };

        c1.StandardExploded += delegate (object sender, CarEventArgs e)
        {
            aboutToBlowCounter++;

            WriteLine($"Exploded=>{((Car)sender)?.PetName} {e.msg}");
        }; for (int i = 0; i < 6; i++)
        {
            c1.AccelerateStandard(20);
        }

        WriteLine($"aboutToBlowCounter={aboutToBlowCounter}");
    }
}