C# 事件（Event）

事件（Event） 基本上說是一個用戶操作，如按鍵、點擊、鼠標移動等等，或者是一些出現，如系統生成的通知。應用程序需要在事件發生時響應事件。例如，中斷。事件是用於進程間通信。

通過事件使用委托

事件在類中聲明且生成，且通過使用同一個類或其他類中的委托與事件處理程序關聯。包含事件的類用於發布事件。這被稱為 發布器（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 fired!");
         }

      }
      public EventTest(int n )
      {
         SetValue(n);
      }
      public void SetValue(int n)
      {
         if (value != n)
         {
            value = n;
            OnNumChanged();
         }
      }
   }
   public class MainClass
   {
      public static void Main()
      {
         EventTest e = new EventTest(5);
         e.SetValue(7);
         e.SetValue(11);
         Console.ReadKey();
      }
   }
}

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

Event Fired!
Event Fired!
Event Fired!

實例 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