页面客户端生命周期
在页面的客户端生命周期中触发事件的两个主要的MS AJAX库类是Application和PageRequestManager类。
发起的请求(GET请求)和同步回传的关键事件是Application实例的load事件。当load事件处理器中的脚本运行时,所有脚本和组件都已经被装载并且可以使用。
当使能UpdatePanel控件的部分页面呈现时,关键的客户端事件是PageRequestManager类的事件。这些事件使你可以处理许多普通场景。包括取消回传,赋予某个回传更高的优先级,和在更新UpdatePanel中的内容时产生动画效果。
为了添加或者移除Application和PageRequestManager类触发的事件的处理器,可以使用这些类的add_eventname和remove_eventname方法。
注意:为了处理Application对象的load和unload事件,你可以使用保留名pageLoad和pageUnload创建函数。
function pageLoad() {
var prm = Sys.WebForms.PageRequestManager.getInstance();
if (!prm.get_isInAsyncPostBack())
prm.add_beginRequest (onBeginRequest);
}
Sys.WebForms.PageRequestManager Events
initialRequest | 在一次异步回传的初始化阶段触发 |
beginRequest | 在开始处理一次异步回传和发送回传请求到服务器之前触发。如果此时有一个回传正在处理,那么可以使用abortPostBack方法停止请求。 |
pageLoading | 在收到来自服务器对一次异步回传的响应之后,但是在更新页面内容之前触发。 |
pageLoaded | 在更新了所有的页面内容之后触发,而不管这是一次同步还是异步回传。 |
endRequest | 在完成异步回传,并且控件已经返回到浏览器之后触发。如果发生错误,页面不会被更新。使用这个事件来提供自定义错误通知或者日志错误。 |
Sys.Application Events
init | 仅在页面首次呈现,并在装载了所有的脚本之后触发一次,但是在创建对象之前。 |
load | 在装载了所有的脚本,并在创建和初始化了应用程序中所有对象之后。注意,异步和同步回传都会触发此事件。 |
unload | 在客户端应用程序中所有对象都被销毁(disposed)之后触发。在此事件处理器中,你应该释放你拥有的所有资源。 |
后记
更多关于MS AJAX的Cheet Sheet可以在这里下载:
http://aspnetresources.com/downloads/ms_ajax_library_cheat_sheets1.zip
它们短小精悍,非常值得一读。