AJAX 中Sys.WebForms.PageRequestManager的事件激发顺序

1.页面第一次进入时，会首先激发add_pageLoaded事件

2.异步提交时，事件的激发顺序如下:

add_initializeRequest

add_beginRequest

add_pageLoading

add_pageLoaded

add_endRequest

add_pageLoaded

 

获取PageRequestManager的实例：var prm = Sys.WebForms.PageRequestManager.getInstance();
属性prm.get_isInAsyncPostBack()：判断一个异步回送是否正在进行中

方法prm.abortPostBack()：把一个正在执行中的异步回送取消。

 

客户端页面的生命周期

 

1、initializeRequest：
触发时机：当一个异步请求的回送被初始化之前引发。
       添加事件处理代码：Sys.WebForms.PageRequestManager.getInstance().add_initializeRequest(initFunc);
       移除事件处理代码：Sys.WebForms.PageRequestManager.getInstance().remove_initializeRequest(initFunc);
           initFunc是该页面初始化之前要执行的客户端方法。该方法的声明为：
           function initFunc(sender,args)
           {
                //args的数据类型是：InitializeRequestEventArgs类型。
                //args.get_postBackElement()：取得初始化异步回送的元素对象。
                   //args.get_postBackElement().id取得初始化异步回送的元素对象的id号
                   //args.get_postBackElement().value取得初始化异步回送的元素对象的value值
                //args.set_cancel(bool)：取消初始化异步回送，即丢弃该异步回送。
           }
        如果异步处理的过程比较慢，在异步处理的过程中再次发出同样的请求的话，那后者的异步处理请求会取消掉前一步未处理完的请求。  这就是默认的异步请求优先级－－“后者优先”。
        我们通常回利用initailizeRequest事件来取消一个异步回送（正在进行的回送和将要初始化的回送）。

2、beginRequest：
       触发时机：在异步请求初始化完成，且向服务器提出请求之前引发。
       添加事件处理代码：Sys.WebForms.PageRequestManager.getInstance().add_beginRequest(beginFunc);
       移除事件处理代码：Sys.WebForms.PageRequestManager.getInstance().remove_beginRequest(beginFunc);
           beginFunc是向服务器提出请求之前要执行的客户端方法。该方法的声明为：
           function beginFunc(sender,args)
           {
                //args的数据类型是：BeginRequestEventArgs类型。
                //args.get_postBackElement()：取得初始化异步回送的元素对象。
           }
        我们通常在beginRequest事件中设置一个标头，或是启始化一个动化告知用户正在进行请求处理。

3、pageLoading：
        触发时机：异步回送已经被服务器接收并响应，但还没有对页面进行任何更新之前引发
        添加事件处理代码：Sys.WebForms.PageRequestManager.getInstance().add_pageLoading(loadingFunc);
        移除事件处理代码：Sys.WebForms.PageRequestManager.getInstance().remove_pageLoading(loadingFunc);
             loadingFunc是页面更新之前要执行的客户端方法。该方法的声明为：
             function loadingFunc(sender,args)
             {
                //args的数据类型是：PageLoadingEventArgs类型。
                //args代表内容将要被更新或删除的UpdatePanel控件的<div>。
                //var arr = args.get_panelsDeleting(); 取得将被删除的各个UpdatePanel控件的<div>
                //var arr = args.get_panelsUpdating();取得将被更新的各个UpdatePanel控件的<div>
             }

 

 

 

 

5、endRequest：
       触发时机：回送请求处理完毕后，就会引发endRequest事件。
       添加事件处理代码：Sys.WebForms.PageRequestManager.getInstance().add_endRequest(endFunc);
       移除事件处理代码：Sys.WebForms.PageRequestManager.getInstance().remove_endRequest(endFunc);
           endFunc是页面请求完成后执行的客户端方法。该方法的声明为：
           function endRequest(sender,args)
           {
                //args的数据类型是：EndRequestEventArgs类型
                //var err = args.get_error()：判断是否发生错误，并取得错误对象。
                //var em = args.get_error().message：取得错误的出错信息。
                //args.set_errorHandled(true)：设置错误已被处理。
                //var gm = args.get_errorHandled()：判断错误是否被处理。
                //异步请求发生异常后，如果程序员不在客户端捕获处理的话，PageRequestManager对象会将其以对话框的形式弹出异常的信息。如果程序员 想自己编写错误处理代码，而不交由PageRequestManager对象处理的话。那程序员可以通过args.get_error().message属性取得错误信息，然后编写异常处理代码，最后记得执行args.set_errorHandled(true)。这样就阻止异常继续回返给PageRequestManager对象。具体使用在后面将详细说明。
           }

4、pageLoaded：
        触发时机：回送完成页面区域被更新之后引发。
        添加事件处理代码：Sys.WebForms.PageRequestManager.getInstance().add_pageLoaded(loadedFunc);
        移除事件处理代码：Sys.WebForms.PageRequestManager.getInstance().remove_pageLoaded(loadedFunc);
           loadedFunc是页面更新后要执行的客户端方法。该方法的声明为：
           function loadedFunc(sender,args)
           {
                //args的数据类型是：PageLoadedEventArgs类型
                //args代表更新的或创建的UpdatePanel控件的<div>
                //var arr = args.get_panelsUpdated();取得被更新的各个UpdatePanel控件的<div>
                //var arr = args.get_panelsCreated();取得新创建的各个UpdatePanel控件的<div>
           }