事件和委托

若要使用在另一个类中定义的事件，必须定义和注册一个事件处理程序。事件处理程序必须具有与为事件声明的委托相同的方法签名。通过向事件添加事件处理程序可注册该处理程序。向事件添加事件处理程序后，每当该类引发该事件时都会调用该方法。

有关阐释引发和处理事件的完整示例，请参见如何：引发和使用事件。

1. 定义一个具有与事件委托相同的签名的事件处理程序方法。
   

   public class WakeMeUp 
   {
       // AlarmRang has the same signature as AlarmEventHandler.
       public void AlarmRang(object sender, AlarmEventArgs e)
       {...};
       ...
   }

2. 使用对该事件处理程序方法的一个引用创建委托的一个实例。调用该委托实例时，该实例会接着调用该事件处理程序方法。

   // Create an instance of WakeMeUp.
   WakeMeUp w = new WakeMeUp();
   
   // Instantiate the event delegate.
   AlarmEventHandler alhandler = new AlarmEventHandler(w.AlarmRang);

3. 将该委托实例添加到事件。引发该事件时，就会调用该委托实例及其关联的事件处理程序方法。

   // Instantiate the event source.
   AlarmClock clock = new AlarmClock();
   
   // Add the delegate instance to the event.
   clock.Alarm += alhandler;

使用事件

要在应用程序中使用事件，您必须提供一个事件处理程序（事件处理方法），该处理程序执行程序逻辑以响应事件并向事件源注册事件处理程序。我们将该过程叫做事件连结。Windows 窗体和 Web 窗体的可视设计器所提供的应用程序快速开发 (RAD) 工具简化（或者说隐藏）了事件连结的详细信息。

本主题介绍处理事件的常规模式。有关 .NET Framework 中事件模型的概述，请参见事件和委托。有关 Windows 窗体中事件模型的更多信息，请参见如何：在 Windows 窗体应用程序中使用事件。有关 Web 窗体中事件模型的更多信息，请参见如何：在 Web 窗体应用程序中使用事件。

事件模式

由于不同 RAD 工具提供不同级别的支持，所以 Windows 窗体和 Web 窗体中的事件连接详细信息是不同的。不过，两个方案遵循同一事件模式，该模式具有下列特征：

• 引发名为 EventName 事件的类具有以下成员：

  public event EventNameEventHandler EventName;

• EventName 事件的事件委托是 EventNameEventHandler，它具有以下签名：

  public delegate void EventNameEventHandler(object sender, EventNameEventArgs e);

要使用 EventName 事件，您的事件处理程序必须与事件委托具有相同签名：

void EventHandler(object sender, EventNameEventArgs e) {}

事件功能是由三个互相联系的元素提供的：提供事件数据的类、事件委托和引发事件的类。.NET Framework 具有命名与事件相关的类和方法的约定。如果希望您的类引发一个名为 EventName 的事件，您需要以下元素：

• 包含事件数据的类，名为 EventNameEventArgs。此类必须是从 System.EventArgs 派生的。
• 事件的委托，名为 EventNameEventHandler。
• 引发事件的类。该类必须提供事件声明 (EventName) 和引发事件 (OnEventName) 的方法。

.NET Framework 类库或第三方类库中可能已经定义了事件数据类和事件委托类。在这种情况下，您就不需要定义这些类了。例如，如果您的事件不使用自定义数据，您可以使用 System.EventArgs 作为事件数据并使用System.EventHandler 作为委托。

使用 event 关键字在类中定义事件成员。当编译器在类中遇到 event 关键字时，它会创建一个私有成员，例如：

private EventNameHandler eh = null;

下面的过程说明如何在类中实现事件。第一个过程实现没有关联数据的事件，它将 System.EventArgs 类和 System.EventHandler 类用作事件数据和委托处理程序。第二个过程实现具有自定义数据的事件，它为事件数据和事件委托处理程序定义自定义类。

有关阐释引发和处理事件的完整示例，请参见如何：引发和使用事件。

1. 定义一个提供事件数据的类。对类 EventNameArgs 进行命名，从 System.EventArgs 派生该类，然后添加所有事件特定的成员。

   public class AlarmEventArgs : EventArgs 
   {
      private readonly int nrings = 0;
      private readonly bool snoozePressed = false;
   
      //Constructor.
      public AlarmEventArgs(bool snoozePressed, int nrings) 
      {
         this.snoozePressed = snoozePressed;
         this.nrings = nrings;
      }
   
      //Properties.
      public string AlarmText {  
         ...
      }
      public int NumRings {
         ...
      }
      public bool SnoozePressed{
         ...
      }
   }

2. 声明事件的委托。对委托 EventNameEventHandler 进行命名。

   public delegate void AlarmEventHandler(object sender, AlarmEventArgs e);

3. 在类中定义名为 EventName 的公共事件成员。将事件成员的类型设置为事件委托类型。

   public class AlarmClock 
   {
       ...
       public event AlarmEventHandler Alarm;
   }

4. 在引发事件的类中定义一个受保护的方法。对 OnEventName 方法进行命名。在该方法中引发该事件。

   public class AlarmClock 
   {
       ...
       public event AlarmHandler Alarm;
       protected virtual void OnAlarm(AlarmEventArgs e)    {      if (Alarm != null)           Alarm(this, e);     }
   }

5. 在类中确定引发该事件的时间。调用 OnEventName 以引发该事件并使用 EventNameEventArgs 传入事件特定的数据。

   Public Class AlarmClock
   {
       ...
       public void Start()
       {
           ...
           System.Threading.Thread.Sleep(300);
           AlarmEventArgs e = new AlarmEventArgs(false, 0);
           OnAlarm(e);
       }
   }

如何：引发和使用事件

下面的示例程序阐释如何在一个类中引发一个事件，然后在另一个类中处理该事件。 AlarmClock 类定义公共事件 Alarm，并提供引发该事件的方法。 AlarmEventArgs 类派生自 EventArgs，并定义 Alarm 事件特定的数据。 WakeMeUp 类定义处理 Alarm 事件的 AlarmRang 方法。 AlarmDriver 类一起使用类，将使用 WakeMeUp 的 AlarmRang 方法设置为处理 AlarmClock 的 Alarm 事件。

该示例程序使用事件和委托和引发事件中详细说明的概念。

// EventSample.cs.
//
namespace EventSample
{  
   using System;
   using System.ComponentModel;

   // Class that contains the data for 
   // the alarm event. Derives from System.EventArgs.
   //
   public class AlarmEventArgs : EventArgs 
   {  
      private readonly bool snoozePressed ;
      private readonly int nrings;

      //Constructor.
      //
      public AlarmEventArgs(bool snoozePressed, int nrings) 
      {
         this.snoozePressed = snoozePressed;
         this.nrings = nrings;
      }

      // The NumRings property returns the number of rings
      // that the alarm clock has sounded when the alarm event 
      // is generated.
      //
      public int NumRings
      {     
         get { return nrings;}      
      }

      // The SnoozePressed property indicates whether the snooze
      // button is pressed on the alarm when the alarm event is generated.
      //
      public bool SnoozePressed 
      {
         get {return snoozePressed;}
      }

      // The AlarmText property that contains the wake-up message.
      //
      public string AlarmText 
      {
         get 
         {
            if (snoozePressed)
            {
               return ("Wake Up!!! Snooze time is over.");
            }
            else 
            {
               return ("Wake Up!");
            }
         }
      }  
   }

   // Delegate declaration.
   //
   public delegate void AlarmEventHandler(object sender, AlarmEventArgs e);

   // The Alarm class that raises the alarm event.
   //
   public class AlarmClock 
   {  
      private bool snoozePressed = false;
      private int nrings = 0;
      private bool stop = false;

      // The Stop property indicates whether the 
      // alarm should be turned off.
      //
      public bool Stop 
      {
         get {return stop;}
         set {stop = value;}
      }

      // The SnoozePressed property indicates whether the snooze
      // button is pressed on the alarm when the alarm event is generated.
      //
      public bool SnoozePressed
      {
         get {return snoozePressed;}
         set {snoozePressed = value;}
      }
      // The event member that is of type AlarmEventHandler.
      //
      public event AlarmEventHandler Alarm;

      // The protected OnAlarm method raises the event by invoking 
      // the delegates. The sender is always this, the current instance 
      // of the class.
      //
      protected virtual void OnAlarm(AlarmEventArgs e)
      {
        AlarmEventHandler handler = Alarm; 
        if (handler != null) 
        { 
           // Invokes the delegates. 
           handler(this, e); 
        }
      }

      // This alarm clock does not have
      // a user interface. 
      // To simulate the alarm mechanism it has a loop
      // that raises the alarm event at every iteration
      // with a time delay of 300 milliseconds,
      // if snooze is not pressed. If snooze is pressed,
      // the time delay is 1000 milliseconds.
      //
      public void Start()
      {
         for (;;)    
         {
            nrings++;      
            if (stop)
            {
               break;
            }

            else if (snoozePressed)
            {
               System.Threading.Thread.Sleep(1000);
               {
                  AlarmEventArgs e = new AlarmEventArgs(snoozePressed, 
                     nrings);
                  OnAlarm(e);
               }
            }
            else
            {
               System.Threading.Thread.Sleep(300);
               AlarmEventArgs e = new AlarmEventArgs(snoozePressed, 
                  nrings);
               OnAlarm(e);
            }           
         }
      }
   }

   // The WakeMeUp class has a method AlarmRang that handles the
   // alarm event.
   //
   public class WakeMeUp
   {

      public void AlarmRang(object sender, AlarmEventArgs e)
      {

         Console.WriteLine(e.AlarmText +"\n");

         if (!(e.SnoozePressed))
         {
            if (e.NumRings % 10 == 0)
            {
               Console.WriteLine(" Let alarm ring? Enter Y");
               Console.WriteLine(" Press Snooze? Enter N"); 
               Console.WriteLine(" Stop Alarm? Enter Q");
               String input = Console.ReadLine();

               if (input.Equals("Y") ||input.Equals("y")) return;

               else if (input.Equals("N") || input.Equals("n"))
               {
                  ((AlarmClock)sender).SnoozePressed = true;
                  return;
               }
               else
               {
                  ((AlarmClock)sender).Stop = true;
                  return;
               }
            }
         }
         else
         {
            Console.WriteLine(" Let alarm ring? Enter Y"); 
            Console.WriteLine(" Stop Alarm? Enter Q");
            String input = Console.ReadLine();
            if (input.Equals("Y") || input.Equals("y")) return;
            else 
            {
               ((AlarmClock)sender).Stop = true;
               return;
            }
         }
      }
   }

   // The driver class that hooks up the event handling method of
   // WakeMeUp to the alarm event of an Alarm object using a delegate.
   // In a forms-based application, the driver class is the
   // form.
   //
   public class AlarmDriver
   {  
      public static void Main (string[] args)
      {  
         // Instantiates the event receiver.
         WakeMeUp w= new WakeMeUp();

         // Instantiates the event source.
         AlarmClock clock = new AlarmClock();

         // Wires the AlarmRang method to the Alarm event.
         clock.Alarm += new AlarmEventHandler(w.AlarmRang);

         clock.Start();
      }
   }   
}

要使用事件属性（Visual Basic 2005 中的自定义事件），请在引发事件的类中定义事件属性，然后在处理事件的类中设置事件属性的委托。要在一个类中实现多个事件属性，该类必须在内部存储和维护为每个事件定义的委托。一种典型方法是实现通过事件键进行索引的委托集合。

若要存储每个事件的委托，可以使用 EventHandlerList 类或实现您自己的集合。集合类必须提供用于基于事件键设置、访问和检索事件处理程序委托的方法。例如，可以使用 Hashtable 类或从 DictionaryBase 类派生一个自定义类。不需要在类以外公开委托集合的实现详细信息。

类中的每个事件属性定义一个 add 访问器方法和一个 remove 访问器方法。事件属性的 add 访问器将输入委托实例添加到委托集合。事件属性的 remove 访问器从委托集合中移除输入委托实例。事件属性访问器使用事件属性的预定义键在委托集合中添加和从委托集合中移除实例。

1. 在引发事件的类中定义一个委托集合。
2. 定义每个事件的键。
3. 在引发事件的类中定义事件属性。
4. 使用委托集合实现事件属性的 add 访问器方法和 remove 访问器方法。
5. 使用公共事件属性可在处理事件的类中添加和移除事件处理程序委托。

// The class SampleControl defines two event properties, MouseUp and MouseDown.
class SampleControl: Component {
   // :
   // Define other control methods and properties.
   // :

   // Define the delegate collection.
   protected EventHandlerList listEventDelegates = new EventHandlerList();

   // Define a unique key for each event.
   static readonly object mouseDownEventKey = new object();
   static readonly object mouseUpEventKey = new object();

   // Define the MouseDown event property.
   public event MouseEventHandler MouseDown {  
      // Add the input delegate to the collection.
      add { listEventDelegates.AddHandler(mouseDownEventKey, value); }
      // Remove the input delegate from the collection.
      remove { listEventDelegates.RemoveHandler(mouseDownEventKey, value); }
   }

   // Define the MouseUp event property.
   public event MouseEventHandler MouseUp {
      // Add the input delegate to the collection.
      add { listEventDelegates.AddHandler(mouseUpEventKey, value); }
      // Remove the input delegate from the collection.
      remove { listEventDelegates.RemoveHandler(mouseUpEventKey, value); }
   }
}