AJAX 中Sys.WebForms.PageRequestManager的事件激发顺序
测试代码:
- 测试代码如下:
-
- <%@ Page Language="C#" AutoEventWireup="true" CodeBehind="Test.aspx.cs" Inherits="AjaxCtpWebDemo.Test" %>
-
- <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
- <html xmlns="http://www.w3.org/1999/xhtml" >
- <head runat="server">
- <title>无标题页</title>
- </head>
- <body>
- <form id="form1" runat="server">
-
- <asp:ScriptManager ID="ScriptManager1" runat="server">
- </asp:ScriptManager>
- <%=DateTime.Now.ToString() %><hr/>
- <asp:UpdatePanel ID="UpdatePanel1" runat="server">
- <ContentTemplate>
- <%=DateTime.Now.ToString() %>
- <hr/>
- <asp:Button ID="Button1" runat="server" Text="Button" />
- </ContentTemplate>
- </asp:UpdatePanel>
- <mce:script type="text/javascript" language="javascript"><!--
- Sys.WebForms.PageRequestManager.getInstance().add_initializeRequest(
- function(sender, e)
- {
- alert("add_initializeRequest");
- }
- );
-
-
- Sys.WebForms.PageRequestManager.getInstance().add_endRequest(
- function(sender,e){
- alert("add_endRequest");
- }
- );
-
-
- Sys.WebForms.PageRequestManager.getInstance().add_beginRequest(
- function(sender,e){
- alert("add_beginRequest");
- }
- );
-
-
- Sys.WebForms.PageRequestManager.getInstance().add_pageLoaded(
- function(sender,e){
- alert("add_pageLoaded");
- }
- );
-
- Sys.WebForms.PageRequestManager.getInstance().add_pageLoading(
- function(sender,e){
- alert("add_pageLoading");
- }
- );
-
-
-
-
- </form>
- </body>
- </html>
最终结果如下:
1.页面第一次进入时,会首先激发add_pageLoaded事件
2.异步提交时,事件的激发顺序如下:
add_initializeRequest
add_beginRequest
add_pageLoading
add_pageLoaded
add_endRequest
add_pageLoaded
转:http://www.cnblogs.com/fifastar/archive/2008/06/02/1212225.html
获取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事件来取消一个异步回送(正在进行的回送和将要初始化的回送)。
- <asp:ScriptManager ID="ScriptManager1" runat="server" />
- <asp:UpdateProgress ID="UpdateProgress1" runat="server" DisplayAfter="0" DynamicLayout="false">
- <ProgressTemplate>
- <span style="color: Red" mce_style="color: Red">Loading...</span>
- </ProgressTemplate>
- </asp:UpdateProgress>
- <asp:UpdatePanel ID="UpdatePanel1" runat="server">
- <ContentTemplate>
- <%=DateTime.Now %><br />
- <asp:Label ID="Label1" runat="server" Text=""></asp:Label><br />
- <asp:Button ID="btnPrecedence" runat="server" Text="优先" OnClick="btnPrecedence_Click" />
- <asp:Button ID="Button2" runat="server" Text="普通" OnClick="btnPrecedence_Click" />
- </ContentTemplate>
- </asp:UpdatePanel>
- <div id="Message" style="color: Red" mce_style="color: Red">
- </div>
-
- <mce:script type="text/javascript" language="javascript"><!--
- var lastPostBackButtonId=null;
- var btnPrecedenceId = "<%=this.btnPrecedence.ClientID %>"
-
- Sys.WebForms.PageRequestManager.getInstance().add_initializeRequest(
- function(sender,e)
- {
-
- var prm = Sys.WebForms.PageRequestManager.getInstance();
-
- if(prm.get_isInAsyncPostBack())
- {
- if(lastPostBackButtonId==btnPrecedenceId)
- {
- e.set_cancel(true);
- if(e.get_postBackElement().id==btnPrecedenceId)
- {
- showMessage("不可重复发起优先的刷新1。");
- }else
- {
- showMessage("请等待优先的刷新结束2。");
- }
- return;
- }
- else if(e.get_postBackElement().id==btnPrecedenceId)
- {
- showMessage("发起优先的刷新,普通的刷新将被取消3。");
- }
- else
- {
- showMessage("重新发起普通刷新,前一次将被取消4。");
- }
- }
- lastPostBackButtonId = e.get_postBackElement().id;
- }
- );
-
-
-
- <mce:script type="text/javascript" language="javascript"><!--
- var timeoutSeed = null;
- function showMessage(message,timeout)
- {
- $get("Message").innerHTML = message;
-
- if(timeoutSeed)
- {
- window.clearTimeout(timeoutSeed);
- }
- timeoutSeed = window.setTimeout(function(){$get("message").innerHTML="";
- },timeout||2500)
- }
-
-
-
- protected void Page_Load(object sender, EventArgs e)
- {
-
- }
- protected void btnPrecedence_Click(object sender, EventArgs e)
- {
- Thread.Sleep(3000);
- Button button = sender as Button;
- Label1.Text = String.Format("您点击了“{0}”按钮", button.Text);
- }
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事件中设置一个标头,或是启始化一个动化告知用户正在进行请求处理。
- <asp:UpdatePanel ID="UpdatePanel1" runat="server">
- <ContentTemplate>
- <%=DateTime.Now %><br />
- <asp:Button ID="Button1" runat="server" Text="Button1" OnClick="Button_Click" />
- </ContentTemplate>
- <Triggers>
- <asp:AsyncPostBackTrigger ControlID="Button2" />
- </Triggers>
- </asp:UpdatePanel>
- <asp:UpdateProgress ID="UpdateProgress1" runat="server" DisplayAfter="0" AssociatedUpdatePanelID="UpdatePanel1">
- <ProgressTemplate>
- <span style="color: Red" mce_style="color: Red">Loading...</span>
- </ProgressTemplate>
- </asp:UpdateProgress>
- <hr />
- <asp:Button ID="Button2" runat="server" Text="Button2" OnClick="Button_Click" />
-
- <mce:script type="text/javascript" language="javascript"><!--
- Sys.WebForms.PageRequestManager.getInstance().add_beginRequest(
- function(sender,e)
- {
- if(e.get_postBackElement().id != "<%=this.Button2.ClientID %>")
- {
- return;
- }
-
- var updateProgress = $get("<%=this.UpdateProgress1.ClientID %>");
- var dynamicLayout = <%=this.UpdateProgress1.DynamicLayout.ToString().ToLower() %>;
- if(dynamicLayout)
- {
- updateProgress.style.display = "block";
- }else
- {
- updateProgress.style.visibility = "visible";
- }
- }
- )
-
-
- protected void Page_Load(object sender, EventArgs e)
- {
-
- }
- protected void Button_Click(object sender, EventArgs e)
- {
- Thread.Sleep(2000);
- }
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对象。具体使用在后面将详细说明。
}
- <asp:UpdatePanel ID="UpdatePanel1" runat="server">
- <ContentTemplate>
- <%=DateTime.Now %><br />
- <asp:Button ID="btnError" runat="server" Text="Error" OnClick="btnError_Click" />
- <asp:Button ID="btnTimeout" runat="server" Text="Timeout" OnClick="btnTimeout_Click" />
- <input id="button" type="button" value="Abort" onclick="Sys.WebForms.PageRequestManager.getInstance().abortPostBack();" />
- <asp:Button ID="btnDataItem" runat="server" Text="Reister DataItem" OnClick="btnDataItem_Click" />
- </ContentTemplate>
- </asp:UpdatePanel>
-
- <mce:script type="text/javascript"><!--
- Sys.WebForms.PageRequestManager.getInstance().add_endRequest(
- function(sender,e){
- if(e.get_error())
- {
- e.set_errorHandled(true);
-
- if(e.get_response().get_timedOut())
- {
- showMessage("您的请求已超时。")
- }else if(e.get_response().get_statusCode() != 200)
- {
- showMessage("遇到未知错误。");
- }else
- {
- showMessage(e.get_error().message);
- }
- }else if(e.get_response().get_aborted())
- {
- showMessage('您的请求已取消')
- }
- else
- {
- var upId = "<%= this.UpdatePanel1.ClientID %>";
- var item =e.get_dataItems()[upId];
- showMessage("您注册了:"+item);
- }
- });
-
-
- protected void Page_Load(object sender, EventArgs e)
- {
- ScriptManager.GetCurrent(Page).AsyncPostBackTimeout = 3;
- }
- protected void btnError_Click(object sender, EventArgs e)
- {
- int two = 2;
- int i = 3 / (two - 2);
- }
- protected void btnTimeout_Click(object sender, EventArgs e)
- {
- Thread.Sleep(5000);
- }
- protected void btnDataItem_Click(object sender, EventArgs e)
- {
- ScriptManager.GetCurrent(this).RegisterDataItem(UpdatePanel1, DateTime.Now.ToString());
- }
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>
}