C# 事件（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