原文地址:http://www.codeproject.com/csharp/events.asp
源代码下载:/Files/edgar-sun/events_src.zip
演示文件下载:/Files/edgar-sun/events_demo.zip
作者:Maysam Mahfouzi
原文发布日期:2003/8/16
原文更新日期:2005/5/14
内容
介绍
什么是委托?
理解事件
event关键字
结尾
介绍
当我设法学习事件与委托时,我阅读了很多文章去完全地理解它们并使用它们,现在我想把我学到的展现在这里,其中有很多知识你也需要学习。
什么是委托?
委托和事件是紧紧联系在一起的。委托是函数(方法)指针,更确切地说,委托保持方法的引用。
委托是一个类。当你创建它的实例的时候,你传递将被委托调用的方法名(做为委托构造器的参数)。
每个委托都有一个特征。例如:
是一个委托声明。我之所以说它有一个特征,是因为它都返回一个int类型的值并带有两个参数,类型分别为
string和bool。
我说过,当你实例化委托时,你传递将被委托调用的方法名做为它的构造器参数。重要的一点是只有与委托具有相同特征的方法才能做为其参数。
看看下面的方法:
你能把这个方法传递给SomeDelegate的构造器做参数,因为它们有相似的特征。
既然你已经知道怎么使用委托,下面让我们来理解事件……
理解事件
一个按钮是一个类,当你点击它的时候,click事件被触发。
一个计时器是一个类,每毫秒触发一个tick事件。
想要知道发生什么了?让我们通过一个例子去学习:
这是一个假定:我们有一个类Counter。这个类有一个CountTo(int counTo,int reachableNum)方法,从0到countTo计数,并且只要计数到reachableNum这个数时会触发一个NumberReached事件。
我们的类有一个事件:NumberReached。事件是委托的变量。我的意思是,如果你声明一个事件,同时也声明某一类型的委托,并且要把event关键字放在声明前面,看起来应该是这样的:
在上面的声明中,NumberReachedEventHandler只是一个委托。也许它更应该叫NumberReachedDelegate,但是注意到微软并没叫MouseDelegate或PaintDelegate,而是叫MouseEventHandler或PaintEventHandler。把它命名为NumberReachedEventHandler而不是NumberReachedDelegate,这只是一个惯例,了解?很好!
你了解了我们声明事件前,需要先定义相应的委托(事件处理者)。它看起来可能是这样的:
NumberReachedEventArgs e);
如你所见,我们委托的名字是:NumberReachedEventHandler,它的特征是返回一个void值,两个参数类型分别为object和NumberReachedEventArgs。如果你在某处实例化这个委托时,你所传递的方法必须和它具有一样的特征。
在你的代码中,你使用过MouseEventArgs或PaintEventArgs去确定鼠标的位置,它在向哪移动,或某个物体的图形属性触发Paint事件么?实际上,在从EventArgs类继承的类中我们提供给使用者我们的数据。例如,在我们的例子中,我们提供那个可达的数。下面是这个类的声明:
{
private int _reached;
public NumberReachedEventArgs(int num)
{
this._reached = num;
}
public int ReachedNumber
{
get
{
return _reached;
}
}
}
如果不需要提供给使用者任何信息,我们可以直接使用EventArgs类。
现在,所有的事都已经准备好了,下面让我们来看一下Counter类的内部实现:
{
public delegate void NumberReachedEventHandler(object sender,
NumberReachedEventArgs e);
/// <summary>
/// Summary description for Counter.
/// </summary>
public class Counter
{
public event NumberReachedEventHandler NumberReached;
public Counter()
{
//
// TODO: Add constructor logic here
//
}
public void CountTo(int countTo, int reachableNum)
{
if(countTo < reachableNum)
throw new ArgumentException(
"reachableNum should be less than countTo");
for(int ctr=0;ctr<=countTo;ctr++)
{
if(ctr == reachableNum)
{
NumberReachedEventArgs e = new NumberReachedEventArgs(
reachableNum);
OnNumberReached(e);
return;//don't count any more
}
}
}
protected virtual void OnNumberReached(NumberReachedEventArgs e)
{
if(NumberReached != null)
{
NumberReached(this, e);//Raise the event
}
}
}
在上面的代码中,如果到达预期的数时就触发一个事件。在这里我们需要考虑很多事情:
1、触发一个事件是通过调用我们的事件(NumberReachedEventHandler的一个实例)完成的。
这样,所有已注册的方法都将被调用。
2、我们给已注册的方法数据通过以下代码:
3、一个问题:我们为什么通过OnNumberReached(NumberReachedEventArgs e)方法间接的调用NumberReached(this,e)事件?为什么我们不用下面的代码:
{
NumberReachedEventArgs e = new NumberReachedEventArgs(reachableNum);
//OnNumberReached(e);
if(NumberReached != null)
{
NumberReached(this, e);//Raise the event
}
return;//don't count any more
}
问的好!如果你想知道为何间接调用,请看OnNumberReached方法的特征:
你看到了,它是保护方法,意味着从这个类继承的类(子类)中它是可以调用的。
同时它也是虚方法,意味着子类可以改写它的实现。
那是非常有用的。想象一下你正在设计一个从Counter类继承的类,通过改写OnNumberReached方法,可以在事件触发之前方便的增加一些附加的工作。例如:
{
//Do additional work
base.OnNumberReached(e);
}
注意如果你不调用base.OnNumberReached(e),那么事件永远也不会触发。当你继承了一些类时,你可能想要去除一些事件,这时这样也许就有用了。有趣的窍门,哈?
一个真实的例子,当你创建一个新的ASP.NET 应用程序时,你去看看后台产生的代码,你会发现你的页面继承自System.Web.UI.Page类,而且有一个叫OnInit的保护虚方法。其中在里面有一个InitializeComponent()方法被调用用来做一些附加的工作,然后再调用基类的OnInit(e)方法:
protected override void OnInit(EventArgs e)
{
//CODEGEN: This call is required by the ASP.NET Web Form Designer.
InitializeComponent();
base.OnInit(e);
}
/// <summary>
/// Required method for Designer support - do not modify
/// the contents of this method with the code editor.
/// </summary>
private void InitializeComponent()
{
this.Load += new System.EventHandler(this.Page_Load);
}
#endregion
4、注意NumberReachedEventHandler委托,它是定义在Counter类外,Events命名空间内的,对所有类都可见。
好了,是时候实践一下我们的Counter类了。
在我们的应用程序中,我们有两个文本框:txtCountTo和txtReachable
这里是btnRun按钮点击事件的事件处理代码:
{
if(txtCountTo.Text == "" || txtReachable.Text=="")
return;
oCounter = new Counter();
oCounter.NumberReached += new NumberReachedEventHandler(
oCounter_NumberReached);
oCounter.CountTo(Convert.ToInt32(txtCountTo.Text),
Convert.ToInt32(txtReachable.Text));
}
private void oCounter_NumberReached(object sender, NumberReachedEventArgs e)
{
MessageBox.Show("Reached: " + e.ReachedNumber.ToString());
}
这里是初始化某个事件的事件委托的语法:
oCounter_NumberReached);
现在你应该了解到我们正在做什么。我们初始化了NunberReachedEvnetHandler委托(也可以对其他对象)。注意我上面提及的oCounter_NumberReached方法签名的相似性。
现在来看看我们用=代替+=的情形。
委托是特殊的对象,因为它可以保持多个对象的引用(这里是多个方法)。例如,如果你有另一个方法叫oCounter_NumberReached2,而且签名和oCounter_NumberReached一样,那么两个方法都可以象下面那样引用:
oCounter_NumberReached);
oCounter.NumberReached += new NumberReachedEventHandler(
oCounter_NumberReached2);
现在,当事件被触发,一个接一个的方法将被调用。
如果在你的代码某处,你不想在NumberReached事件触发时调用oCounter_NumberReached2,你可以这样做:
oCounter_NumberReached2);
event关键字
许多人也许会问:如果我们不用event关键字会怎么样?
使用evnet关键字可以阻止任何一个委托的使用者把它设为null。为什么这是重要的?想象一下,一个客户把我类中的其中一个方法注册到委托调用链表,其他客户也这样做,这不会出错。现在,如果有另一客户用=代替+=给委托新注册一个方法。这将会把原来的委托调用链表清空,并且创建一个全新的单一的委托在委托调用链表中。这时其他客户将无法接收回复信息。关键字event正是针对这一问题提出的,如果我在Counter类中加上event关键字,并试着编译下面的代码,将产生一个编译器错误信息:
总之,event关键字在委托实例上加了一层保护,保护客户的委托以免被重新设置及委托调用链被清空,这样就只允许对委托调用链进行添加或移除操作。
结尾
别忘了在你应用程序的构造函数中声明以下内容,而不是在cmdRun_Click事件处理代码中。我那样做仅仅只为了简单。;-)
{
//
// Required for Windows Form Designer support
//
InitializeComponent();
//
// TODO: Add any constructor code after InitializeComponent call
//
oCounter = new Counter();
oCounter.NumberReached += new NumberReachedEventHandler(
oCounter_NumberReached);
oCounter.NumberReached += new NumberReachedEventHandler(
oCounter_NumberReached2);
提供的源代码就是这样子的。
如果你投5分以下,让我知道原因,;-)。我希望你满意这篇文章。