C#自定义事件实现简介

喜欢ヅ旅行 2022-09-19 13:28 195阅读 0赞

目标：通过一个实例来按步骤说明C\#自定义事件如何创建，引发，接收和取消。例子是一个窗体程序，一个按钮和一个标签，点击按钮的时候就触发一个事件得到当前时间，如果秒是后30秒就输出一个Wasn't a right time!!

**创建一个事件类型：**

1.新建一个窗体应用程序，添加一个button和lebelInfo，name分别为buttonRaise和labelInfo。

2.定义一个委托：

在窗体类的声明部分添加

public delegate void ActionEventHandler(object sender, ActionCancelEventArgs e);

这里我们声明了一个新的委托类型ActionEventHandler，原因是我们后面要自己定制EventArg类(上面可见就是ActionCancelEventArgs类)，方法名必须和委托匹配。

3.定义一个C\#自定义事件：

在上面代码后面加上，

public static event ActionEventHandler Action;

我们定义了一个叫Action的事件，事件定义的语法要求指定与事件相关的委托。

4.创建自己定义的EventArg类：

在程序中定义一个类代码如下：

namespace WindowsApplication1  
       {  
          public class ActionCancelEventArgs : System.ComponentModel.CancelEventArgs  
          {  
             string message = String.Empty;  
        
             public ActionCancelEventArgs() : base() { }  
        
             public ActionCancelEventArgs(bool cancel) : base(cancel) { }  
        
             public ActionCancelEventArgs(bool cancel, string message)  
                : base(cancel)  
             {  
                this.message = message;  
             }  
        
             public string Message  
             {  
                get { return message; }  
                set { message = value; }  
             }  
          }  
       }

这个新类ActionCancelEventArgs实际上派生于CancelEventArgs，而CancelEventArgs派生于EventArgs。CancelEventArgs添加了Cancel属性，是一个bool类型，它通知sender对象，接收器希望取消或者停止事件的处理。我们为ActionCancelEventArgs添加一个message属性，包含事件处理时候传递一个事件处理状态的字符串。

所有的基于EventArgs的类都负责在发送器和接收器之间来回传送事件的信息。大多情况下，EventArgs类中使用的信息都被事件处理程序中的接收器对象(这里后来的ActionCancelEventArgs ev)所使用。但是有时候，事件处理程序可以把信息添加到EventArg类中，使之可以用于发送器。我们这里就是这样做的其实(接收器根据状态把信息传给发送器中的message属性了)。

**引发事件：**

1.通过一种动作来激活Action事件(我们就用点击按钮buttonRaise)：

先为buttonRaise按钮添加一个点击事件处理程序：

private void buttonRaise_Click(object sender, EventArgs e)

2.再在处理程序中用正确的参数调用事件：添加如下代码，

ActionCancelEventArgs cancelEvent = new ActionCancelEventArgs();  
       OnAction(this, cancelEvent);

就是先创建一个新的事件数据类型ActionCancelEventArgs，再把它当作参数传递给前面定义的那个Action事件的处理程序(引发事件是通过Action(this, cancelEvent)的，但是我们通过OnAction()来调用之)。这里我们的Action事件就相当我们.Net中的Move,Click事件一样的了，但是目前它还是空的，如果引发了这个事件就会产生一个空引用异常，所以我们如果在其他的类中把Action事件定义为基事件，则只要引发了Action就要定义相关的事件处理程序的。

3.我们定义一个叫OnAction的函数引发事件，(加上On是命名约定)

protected void OnAction(object sender, ActionCancelEventArgs e)  
       {  
           if (Action != null)    //捕获空引用错误  
               Action(sender, e);  
       }

如果派生一个包含该方法和事件的新类，就必须重写OnAction方法，并且在重写代码中调用base.OnAction()，引发此事件。

**接受事件，并且处理之：**

1.下面就是定义一个新类BusEntity了：

namespace WindowsApplication1  
       {  
          public class BusEntity  
          {  
             string time = String.Empty;  
        
             public BusEntity()  
             {  
                Form1.Action += new Form1.ActionEventHandler(Form1_Action);  
             }  
        
             private void Form1_Action(object sender, ActionCancelEventArgs e)  
             {  
                e.Cancel = !DoActions();  
                if (e.Cancel)  
                   e.Message = "Wasn't the right time.";  
             }  
        
             private bool DoActions()  
             {  
                bool retVal = false;  
                DateTime tm = DateTime.Now;  
        
                if (tm.Second <  30)  
                {  
                   time = "The time is " + DateTime.Now.ToLongTimeString();  
                   retVal = true;  
                }  
                else 
                   time = "";  
        
                return retVal;  
             }  
        
             public string TimeString  
             {  
                get { return time; }  
             }  
          }  
       }

其中关键代码：

1.构造函数中声明了Form1.Action事件的处理程序(注册事件)：

Form1.Action += new Form1.ActionEventHandler(Form1_Action);

注意这里注册的是Form1中定义的那个Action事件，不是其它地方定义的。

2.Action事件的处理程序(在前面Form1类中通过OnAction()引发的)：

private void Form1_Action(object sender, ActionCancelEventArgs e)

其中的处理是通过调用DoAction函数来的。它返回一个bool值，并且将状态信息赋值给事件数据类型ActionCancelEventArgs的参数的message成员。

3.完善Form1程序：

(1)类中要先新建成员private BusEntity busEntity;

(2)构造函数中初始化之：busEntity = new BusEntity();

(3)完善点击按钮的事件处理，引发并且处理Action事件：

private void buttonRaise_Click(object sender, EventArgs e)  
       {  
           ActionCancelEventArgs cancelEvent = new ActionCancelEventArgs();  
           OnAction(this, cancelEvent);  
           if (cancelEvent.Cancel)  
               labelInfo.Text = cancelEvent.Message;  
           else 
               labelInfo.Text = busEntity.TimeString;  
       }

在补充说明：这里创建了ActionCancelEventArgs对象，接着引发了Action事件，并且传递了新建的ActionCancelEventArgs对象cancelEvent。在调用OnAction方法，引发事件的时候，BusEntity对象中Action事件处理程序的代码就会执行。如果还有其他对象注册了事件，它们同样会执行。记住：如果其他对象也处理了事件Action，它们也会看到同一个ActionCancelEventArgs对象。如果需要确定是哪个对象取消了事件，而且如果多个对象取消了事件，就要在ActionCancelEventArgs类中再包含某种基于列表的数据结构。

**取消事件：**

在与委托一起注册的处理程序执行完之后，就可以查询ActionCancelEventArgs对象，并且确定它是否被取消了。也就是下面代码：

if (cancelEvent.Cancel)  
           labelInfo.Text = cancelEvent.Message;  
       else 
           labelInfo.Text = busEntity.TimeString;

总结：上面就是我个人通过《Professional C\# 2005 with .Net 3.0》一书中的相关部分，总结出的如何利用事件和事件中基于EventArgs的对象，在应用程序中传递信息的,生成C\#自定义事件。程序示例来源于此教程。