C# 事件（Event）

事件（Event） 基本上說是一個用戶操作，如按鍵、點擊、滑鼠移動等等，或者是一些提示資訊，如系統生成的通知。應用程式需要在事件發生時回應事件。例如，中斷。

C# 中使用事件機制實現線程間的通信。

通過事件使用委託

事件在類中聲明且生成，且通過使用同一個類或其他類中的委託與事件處理程式關聯。包含事件的類用於發佈事件。這被稱為 發佈器（publisher） 類。其他接受該事件的類被稱為 訂閱器（subscriber） 類。事件使用 發佈-訂閱（publisher-subscriber） 模型。

發佈器（publisher） 是一個包含事件和委託定義的對象。事件和委託之間的聯繫也定義在這個對象中。發佈器（publisher）類的對象調用這個事件，並通知其他的對象。

訂閱器（subscriber） 是一個接受事件並提供事件處理程式的對象。在發佈器（publisher）類中的委託調用訂閱器（subscriber）類中的方法（事件處理程式）。

聲明事件（Event）

在類的內部聲明事件，首先必須聲明該事件的委託類型。例如：

public delegate void BoilerLogHandler(string status);

然後，聲明事件本身，使用 event 關鍵字：

// 基於上面的委託定義事件

public event BoilerLogHandler BoilerEventLog;

上面的代碼定義了一個名為 BoilerLogHandler 的委託和一個名為 BoilerEventLog 的事件，該事件在生成的時候會調用委託。

實例

實例 1

using System;
namespace SimpleEvent
{
  using System;
  /***********發佈器類***********/
  public class EventTest
  {
    private int value;

    public delegate void NumManipulationHandler();


    public event NumManipulationHandler ChangeNum;
    protected virtual void OnNumChanged()
    {
      if ( ChangeNum != null )
      {
        ChangeNum(); /* 事件被觸發 */
      }else {
        Console.WriteLine( "event not fire" );
        Console.ReadKey(); /* 回車繼續 */
      }
    }


    public EventTest()
    {
      int n = 5;
      SetValue( n );
    }


    public void SetValue( int n )
    {
      if ( value != n )
      {
        value = n;
        OnNumChanged();
      }
    }
  }


  /***********訂閱器類***********/

  public class subscribEvent
  {
    public void printf()
    {
      Console.WriteLine( "event fire" );
      Console.ReadKey(); /* 回車繼續 */
    }
  }

  /***********觸發***********/
  public class MainClass
  {
    public static void Main()
    {
      EventTest e = new EventTest(); /* 實例化對象,第一次沒有觸發事件 */
      subscribEvent v = new subscribEvent(); /* 實例化對象 */
      e.ChangeNum += new EventTest.NumManipulationHandler( v.printf ); /* 註冊 */
      e.SetValue( 7 );
      e.SetValue( 11 );
    }
  }
}

當上面的代碼被編譯和執行時，它會產生下列結果：

event not fire
event fire
event fire

本實例提供一個簡單的用於熱水鍋爐系統故障排除的應用程式。當維修工程師檢查鍋爐時，鍋爐的溫度和壓力會隨著維修工程師的備註自動記錄到日誌檔中。

實例 2

using System;
using System.IO;

namespace BoilerEventAppl
{

   // boiler 類
   class Boiler
   {
      private int temp;
      private int pressure;
      public Boiler(int t, int p)
      {
         temp = t;
         pressure = p;
      }

      public int getTemp()
      {
         return temp;
      }
      public int getPressure()
      {
         return pressure;
      }
   }
   // 事件發佈器
   class DelegateBoilerEvent
   {
      public delegate void BoilerLogHandler(string status);

      // 基於上面的委託定義事件
      public event BoilerLogHandler BoilerEventLog;

      public void LogProcess()
      {
         string remarks = "O. K";
         Boiler b = new Boiler(100, 12);
         int t = b.getTemp();
         int p = b.getPressure();
         if(t > 150 || t < 80 || p < 12 || p > 15)
         {
            remarks = "Need Maintenance";
         }
         OnBoilerEventLog("Logging Info:\n");
         OnBoilerEventLog("Temparature " + t + "\nPressure: " + p);
         OnBoilerEventLog("\nMessage: " + remarks);
      }

      protected void OnBoilerEventLog(string message)
      {
         if (BoilerEventLog != null)
         {
            BoilerEventLog(message);
         }
      }
   }
   // 該類保留寫入日誌檔的條款
   class BoilerInfoLogger
   {
      FileStream fs;
      StreamWriter sw;
      public BoilerInfoLogger(string filename)
      {
         fs = new FileStream(filename, FileMode.Append, FileAccess.Write);
         sw = new StreamWriter(fs);
      }
      public void Logger(string info)
      {
         sw.WriteLine(info);
      }
      public void Close()
      {
         sw.Close();
         fs.Close();
      }
   }
   // 事件訂閱器
   public class RecordBoilerInfo
   {
      static void Logger(string info)
      {
         Console.WriteLine(info);
      }//end of Logger

      static void Main(string[] args)
      {
         BoilerInfoLogger filelog = new BoilerInfoLogger("e:\\boiler.txt");
         DelegateBoilerEvent boilerEvent = new DelegateBoilerEvent();
         boilerEvent.BoilerEventLog += new
         DelegateBoilerEvent.BoilerLogHandler(Logger);
         boilerEvent.BoilerEventLog += new
         DelegateBoilerEvent.BoilerLogHandler(filelog.Logger);
         boilerEvent.LogProcess();
         Console.ReadLine();
         filelog.Close();
      }//end of main

   }//end of RecordBoilerInfo
}

當上面的代碼被編譯和執行時，它會產生下列結果：

Logging info:

Temperature 100
Pressure 12

Message: O. K