ASP.NET2.0服务器控件之捕获回传事件

ASP.NET2.0服务器控件之捕获回传事件2007-05-10 天极金属边缘上一篇文章介绍了实现自定义服务器控件事件的基本概念。本文将通过典型示例讲解捕获回传事件的实现方法。

1. 实现捕获回传事件

如果服务器控件需要捕获来自客户端的回传事件，并想为该回传事件自定义服务器端事件处理逻辑，那么控件必须实现System.Web.UI.IPostBackEventHandler接口。下面列举了该接口定义。

public interface IPostBackEventHandler
{
 void RaisePostBackEvent（string eventArgument）;
}

如上代码所示，IPostBackEventHandler接口仅包括一个成员方法RaisePostBackEvent。该方法使服务器控件能够处理将窗体发送到服务器时引发的事件，其参数eventArgument表示要传递到事件处理程序的可选事件参数。开发人员可以在RaisePostBackEvent方法中实现服务器控件回传过程中执行的逻辑。一般情况下，RaisePostBackEvent方法将引发一个或者多个服务器端事件。以下代码片段显示了在服务器上引发Click事件的RaisePostBackEvent实现。

public void RaisePostBackEvent（String eventArgument）
{
 OnClick（EventArgs.Empty）;
}

实现捕获回传事件并不是仅仅使服务器控件类实现IPostBackEventHandler接口，并实现该接口成员方法就可以的。开发人员还需要注意实现其他内容。下面列举了实现捕获回传事件过程中的三个要点。

第一，也是最重要的，即自定义服务器控件类必须实现IPostBackEventHandler接口，并实现该接口成员RaisePostBackEvent方法。这一过程在上文中已经进行了介绍。

第二，为控件分配UniqueID。

定义引起回传事件的控件的name属性值为UniqueID，是正确实现RaisePostBackEvent方法的关键之一。当引发回传后，页框架就会搜索发送的内容，并确定发送对象的名称是否与实现IPostBackEventHandler的服务器控件的UniqueID对应。如果对应，页框架就会在该控件上调用RaisePostBackEvent方法。这里的重点是需要开发人员在呈现逻辑中，为控件的name属性分配UniqueID。下面列举了一个简单的代码示例。

protected override void Render（HtmlTextWriter output）
{
 output.Write（"<INPUT TYPE=submit name="+this.UniqueID+"Value="Click Me" />"）;
}

如上代码所示，在控件呈现方法Render中，呈现了一个按钮，其name属性值为UniqueID。只有为引起回传的控件的name属性分配了UniqueID，才能够正确实现捕获回传事件。

第三，实现事件属性结构。

事件属性结构是一种优化的事件实现方式。在介绍之前，我们首先看看常见的控件事件实现方式。具体代码如下所示。

......
public class WebCustomControl:WebControl,IPostBackEventHandler{
 //声明Click事件委托
 public event EventHandler Click;
 //实现RaisePostBackEvent方法
 void IPostBackEventHandler.RaisePostBackEvent（string eventArgument） {
  OnClick（EventArgs.Empty）;
 }
 //定义OnClick事件处理程序
 protected virtual void OnClick（EventArgs e） {
  if（Click ！= null） { Click（this,e）; }
 }
 ......
}