[导入][Joe 原创]Web Control 开发系列(三) 解析IPostBackEventHandler和WebForm的事件机制

       WebForm最大的魅力大概就是它自己的一套事件处理机制了,要做一个好的Control,必须深入理解这套机制,只有这样才可以让我们的Control有一整套Professional的Event,而IPostBackDataHandler和IPostBackEventHandler是实现事件机制的核心接口,在我的上一篇文章(Web Control 开发系列(二) 深入解析Page的PostBack过程和IPostBackDataHandler)中已经介绍了IPostBackDataHandler的实现原理,本章主要介绍IPostBackEventHandler.最后进行总结,来看看Web Control整个事件机制的全貌。
       要了解IPostBackEventHandler接口,首先就必须了解.net Framework的脚本注册原理和一些重要的内置脚本。
   一、脚本注册   
      .net Framework可以在我们毫不知情的情况下,根据我们在服务端对Control属性的设置,在ControlRender的时候,根据需要动态向客户端注册脚本和Hidden的<input>元素,Hidden的<input>用来在客户端保存一些重要的信息,而脚本是用来完成一些逻辑行为的控制。我们先看看.net Framwork是如何实现脚本和Hidden <input>的.
     
      WebForm编程过程中,如果我们希望向客户端输出脚本或者一些Hidden的<input>元素,我们通常是通过 Page.ClientScript对象完成的,这个对象是一个ClientScriptManager类型的实例,我们一般(也有特殊情况)在Control.OnPreRender()方法里面调用Page.ClientScript.RegisterHiddenFiled或者Page.ClientScript.RegisterStartScript,还可以获得一些内置的脚本,比如 Page.ClientScript.GetPostBackEventReference,这些方法的调用都会记录一些标记数据,真正输出到客户端,是在Page的Render方法调用的时候,而完成输出的是下面两个方法:
  
   Page.BeginFormRender 和Page.EndFormRender
     这两个方法会在HtmlForm.RenderChildren里面调用,用来给<form>的开始和结束位置添加一些脚本和hidden field。具体完成的功能有:

    * Render所有Register的Hidden Fields,同时也Render用来保存ViewState的Hidden Field
    * Render用来保存当前 <form>的滚动位置的Hidden Field和Start Javascript
    * Render控制当前焦点的Focus.js脚本引用语句
    * Render用来执行回调的__doPostBack()函数,仅仅在相关标记打开的时候才会Render.
    * Render用来执行PostBack的WebForms.js脚本引用语句。这个文件主要包含了WebForm常用的脚本,有PostBack的脚本和CallBack的脚本。
    * Render已经注册的脚本块(Script Block)
    * Renderl Client Startup Script(启动即执行的脚本)

__doPostBack()脚本
Render出来的__doPostBack()如下:
<script type="text/javascript">
//<![CDATA[
var theForm = document.forms['form1'];
if (!theForm) {
    theForm 
= document.form1;
}

function __doPostBack(eventTarget, eventArgument) {
    
if (!theForm.onsubmit || (theForm.onsubmit() != false)) {
        theForm.__EVENTTARGET.value 
= eventTarget;
        theForm.__EVENTARGUMENT.value 
= eventArgument;
        theForm.submit();
    }

}

//]]>
</script>
其实一旦用户注册了__doPostBack函数,两个配套的Hidden字段也会同步注册
<input type="hidden" name="__EVENTTARGET" id="__EVENTTARGET" value="" />
<input type="hidden" name="__EVENTARGUMENT" id="__EVENTARGUMENT" value="" />
上面的代码就是先把Event target和Event Argument存入指定的Hidden Field中,然后调用<form>的submit方法来提交数据。这段脚本是Framework提供的最普通的引发PostBack的脚本,我们写Control的时候可以通过Page.ClientScript.GetPostBackEventReference来获得这个脚本(注意,这个方法有好几个重载的版本,其中当选用了一些参数的时候,也可能获得另一个脚本WebForm_DoPostBackWithOptions,下面将介绍)。

WebForm_DoPostBackWithOptions脚本
还有一个比较重要的脚本就是WebForm_DoPostBackWithOptions,它的作用比__doPostBack更强,比如对于支持CauseValidation属性的Control,如Checkbox,TextBox,这些Control当CauseValidation为true的时候,它就会在onclick属性里面Render出WebForm_DoPostBackWithOptions脚本。这样可以在调用theForm.submit()方法之前执行当前Form的所有Validator的客户端校验。
      所以事实上,WebForm_DoPostBackWithOptions是包容__doPostBack函数的,凡是注册了WebForm_DoPostBackWithOptions的地方,必须注册__doPostBack,因为WebForm_DoPostBackWithOptions里面在执行完很多附加功能的代码(如对所有的Validator进行校验,控制Focus在没有通过校验的Control等)后,如果一切正常并且需要做ClientSubmit(Button当UseSumitBehavior为true和ImageButton不使用Client Script Submit,它们自己提交,因为它们自己输出的就是可以触发<form>提交的<input>元素),就调用__doPostBack。只有调用__doPostBack才会给__EVENTTARGET和__EVENTARGUMENT设置值,所以Button(UseSumitBehavior为true)和ImageButton引起的回传的时候,我们观察__EVENTTARGET和__EVENTARGUMENT,会发现都为“”。

二、使用脚本进行PostBack的Control分析

注意首先要说明的一点是在HTML的表单域里面,具备自动让<form>想服务器端发送数据,引起回传的只有两个:
   <input type="submit">
   <input type="image">
Button
这是个特殊的Control,因为它们本身具备了自动调用<form>submit的能力,Button上面有一个属性叫UseSubmitBehavior,这个属性用来控制生成的<Input>的type是"submit"还是"button",如果为true,那么就是"submit".
1. 如果CauseValidation为false,UserSubmitBehavior为true,那么意味着仅仅进行提交,并不校验,所以这个时候,生成的代码是
<input type="submit" name="Button1" value="Button" id="Button1" />
没有任何onclick的脚本调用。
2. 如果CauseValidation为true, UseSubmitBehavior为true,那么生成的代码是
<input type="submit" name="Button1" value="Button" onclick="javascript:WebForm_DoPostBackWithOptions(new WebForm_PostBackOptions(&quot;Button1&quot;, &quot;&quot;, true, &quot;&quot;, &quot;&quot;, false, false))" id="Button1" />
因为要执行校验,所以必须调用WebForm_DoPostBackWithOptions方法。
3. 如果CauseValidation为false,UseSubmitBehavior为false,那么生成的代码是
<input type="button" name="Button1" value="Button" onclick="javascript:__doPostBack('Button1','')" id="Button1" />
这个时候,因为type是“button”,它不具备submit数据的能力,所以只能用脚本帮助解决,同时不需要校验,所以就使用__doPostBack函数,如果CauseValidataion为true,onclick里面的函数就为WebForm_DoPostBackWithOptions,因为__doPostBack不具备客户端校验的能力。

ImageButton
     imageButton 比较特别的是同时实现了IPostBackDataHandler, IPostBackEventHandler, 在Asp.net2.0里面只有两个Control同时实现了这两个接口,一个是ImageButton,一个是HtmlInputImage。这两个Control最后生成的都是<input type="image">.
     对于这个HTML元素,它在点击的时候,会引起<form>submit数据,同时会把当前点击的位置作为两个表单域被<form>收集。比如:<input type="image" name="myImageButton">,那么点击到(20,100)的时候,<form>表单域里面会多出两个:["myImageButton.x"] = "20",["myImageButton.y"] = "100".
     通过上面的介绍,我们知道<input type="image">提交的数据和它的Name并不一致,根据我上一篇文章(Web Control 开发系列(二) 深入解析Page的PostBack过程和IPostBackDataHandler)的介绍,我们知道它必须使用注册的方法才能保证page在处理Request的时候调用当前Control的IPostBackDataHandler接口。具体做法就是在PreRender的时候调用Page.RegisterRequiresPostBack(this).
    同上面介绍的Button一样,当CauseValidation为true的时候,会给输出加一个onclick="WebForm_DoPostBackWithOptions"的属性设置,这样在提交前可以使用脚本进行校验。否则就不会生成脚本。

CheckBox,TextBox,RadioButton,ListControl及其派生类 等
    这些Control输出的Html元素都没有自动submit的能力,所以这些Control普通情况下是不会引发回传的,但是为了方便用户,.net Framework在上面暴露了一个属性叫AutoPostBack,一旦这个属性为true,就表示这些Control具备了引发回传的能力,具体怎么实现回传呢,还是依赖于上面介绍的两段脚本。
     当AutoPostBack为true,CauseValidation为true的时候就注册WebForm_DoPostBackWithOptions. 当AutoPostBack为true,CasuseValidataion为false的时候就注册 __doPostBack函数,同时在AutoPostBack属性为true的时候,为了防止性能问题,一般注册的脚本都用setTimeout(函数名,0)包起来,这样可以认为是一个模拟的异步调用(事实JavaScript是单线程的,这样的调用会自动进入调用队列,等待执行,不会阻塞现在的调用)。

三、服务器端处理
      通过上面的分析知道,.net Framework一般是通过注册脚本,在脚本里面调用theForm.submit()来进行提交的,这样就形成了一次PostBack,而可以导致回传的两个重要的脚本也已经在上面介绍了。那么当脚本导致回传了,服务器端是如何处理请求并引发Control的事件的呢?
      通过我第一篇文章(Web Control 开发系列(一) 页面的生命周期)的介绍,我们知道在页面Load阶段结束后,如果Page.IsPostBack,我们会先进入 IPostBackDataHandler的处理阶段,然后才进入IPostBackEventHandler处理阶段。我们下面分析的就是 IPostBackEventHandler处理阶段的逻辑。这个逻辑是通过 Page.RaisePostBackEvent(NameValueCollection postData)进入的。
      在这个函数的处理里面有好几种情况:
      1. 其中最普通的一种处理是通过postData["__EVENTTARGET"]postData[“__EVENTARGUMENT”]拿到相应的 值,这些值都是在<form>提交前通过脚本设置上去的,然后通过Page.FindControl来找到合适的Control,这样就可 以取到Control.PostBackEventHandler,然后调用 IPostBackEventHandler.RaisePostBackEvent方法,就导致Control的服务端事件被触发。
       2. 还有一种情况,就是服务器端的Control是Button或者ImageButton,它们的提交是通过Html元素自己的能力,所以提交发生的时候,没有任何脚本调用,自然postData["__EVENTTARGET"]和 postData[“__EVENTARGUMENT”]都为"",这个时候我们如何找到引发PostBack的Control并且调用它的 IPostBackEventHandler接口的方法呢?
           这就要利用另一种发事件的机制——注册机制。这个机制主要通过 Page.RegisterRequiresRaiseEvent(IPostBackEventHandler control)函数实现的,这个函数在Asp.net2.0中有三个地方调用:
  •      HtmlInputImage.LoadPostData,
  •      ImageButton.LoadPostData,
  •      Page.ProcessPostData
     这三个地方的调用都是在处理PostBackData阶段,因此我们可以认为这个注册机制最好在处理PostBackData阶段使用是比较符合规范的。
     对于HtmlInputImage和ImageButton这两个Control,它们都有PostBackData,而且通过注册的方法实现了IPostBackDataHandler接口,所以在LoadPostData阶段调用Page.RegisterRequiresRaiseEvent,这样就显式的告诉Page在PostBackEvent处理阶段调用自己的IPostBackEventHandler接口,就实现了服务端Click事件的触发。

     那么Page.ProcessPostData函数(在我的上一篇文章Web Control 开发系列(二) 深入解析Page的PostBack过程和IPostBackDataHandler有介绍),它会收集所有的表单提交数据,如果有和这个数据对应的Control(通过Page.FindControl查找),那么就设法调用其IPostDataHandler,如果IPostDataHandler为null,那么设法取其IPostEventHandler,如果不为null,那么就调用Page.RegisterRequiresRaiseEvent函数来注册它。Button只实现了IPostBackEventHandler接口,没有实现IPostBackDataHandler接口,所以就通过这种发式来触发事件的。

     一旦在Page上进行了Page.RegisterRequiresRaiseEvent注册,系统就不会关心postData["__EVENTTARGET"]和postData["__EVENTARGUMENT"]了,直接就调用注册的IPostBackEventHandler.RaisePostBackEvent方法。

上面介绍的内容都是对Page.RaisePostBackEvent的分析:
private void RaisePostBackEvent(NameValueCollection postData)
        
{
            
// 1. 假如已经在Page上显式的注册了引起PostBackEvent的Control,就直接处理
            if (this._registeredControlThatRequireRaiseEvent != null)
            
{
                
this.RaisePostBackEvent(this._registeredControlThatRequireRaiseEvent, null);
            }

            
else
            
{
                
// 这部分代码,我自己按照Reflector反编译的结果重新组织了,但是逻辑
                
// 没有任何变化,只是方便阅读理解

                
// 2. 假如没有注册,就查找__EVENTTARGET记录的Control来处理
                string str = postData["__EVENTTARGET"];
                
bool flag = !string.IsNullOrEmpty(str);
                Control control 
= null;
                
if (flag)
                
{
                    control 
= this.FindControl(str);
                    
if ((control != null&& (control.PostBackEventHandler != null))
                    
{
                        
string eventArgument = postData["__EVENTARGUMENT"];
                        
this.RaisePostBackEvent(control.PostBackEventHandler, eventArgument);
                    }

                }

                
else if (this.AutoPostBackControl == null)
                
{
                    
// 这个AutoPostBackControl的标记设置为了不重复做Validate,后面我在讲述
                    
// Validation机制的时候会介绍
                    this.Validate();
                }

            }

        }

四、Composite Control 的冒泡事件
            在Control上面有一个方法RaiseBubbleEvent,这个方法就是沿着Control Tree向上一次调用OnBubbleEvent函数,知道返回true,就推出,是一个典型的冒泡事件。Control对于OnBubbleEvent的实现是简单的返回false,也就是说如果我们不做处理,那么事件会不停的向上冒泡知道最顶端的Page。
protected void RaiseBubbleEvent(object source, EventArgs args)
{
    
for (Control control = this.Parent; control != null; control = control.Parent)
    
{
        
if (control.OnBubbleEvent(source, args))
        
{
            
return;
        }

    }

}


     我们知道了这个冒泡的机制,那么冒泡的源头在哪里呢??这就是我们做Control的人要考虑的,如果我们希望我们的Control的Event支持冒泡,那么我们就应该在Control的Event发生的时候调用RaiseBubbleEvent这个函数,这样当别人在一个复合控件里面使用我们的Control的时候,它就可以在外面接收到我们Control发的冒泡事件,目前调用了这个冒泡函数的Control有

     从上面,我们最值得注意的是有三个简单Control实现了向上冒泡:Button, ImageButton, LinkButton,其它的都是一些复合Control在OnBubbleEvent里面进行二次冒泡。因此如果我们做一个复合的Control,我们可以在最外层的OnBubbleEvent函数里面监听这个Control内部的所有的Button,ImageButton,LinkButton的事件。

五、总结
     所有WebForm事件的根源依赖于Form的submit()执行而引起PostBack(CallBack这里不考虑),而引起PostBack主要依赖于Html Input (type="image" or "submit")元素和脚本。
     然后在PostBack阶段分析数据,如果数据变化可以Raise相关的Event,如果客户端记录了谁发了Event,也可以发Event。如果想让Event冒泡,就call RaiseBubbleEvent
    





[新闻]梁公军:浅议开放平台今后几年的发展趋势
文章来源:http://www.cnblogs.com/joeliu/archive/2008/07/10/1235423.html
posted @ 2008-07-11 12:15  潜水员  阅读(245)  评论(0编辑  收藏  举报