st Event
[初始化请求事件]
该事件发生在一个异步请求开始时。你可以通过使用该事件来取消一个传统的回送,例如让一个异步回送获得优先。
初始化请求事件需要一个 Sys.WebForms.InitializeRequestEventArgs 对象提供的 eventargs 参数。该对象提供了那些引起回送和暗藏的(underlying)请求的对象的有用的元素。该事件还暴露了 cancel 属性。如果你设置 cancel 值为 true,一个新的回送将被撤销。
beginRequest Event
[开始请求事件]
该事件是在一个回送到服务器的异步回送开始前引发。如果当前已经存在了一个回送进程,则会被停止(by using the abortPostBack method)。你可以使用该事件来设置请求的头部或显示一个有趣的(animation)提示在页面中,表示该请求正在进行中。
该事件需要一个 Sys.WebForms.BeginRequestEventArgs 对象作为 eventargs 参数。该对象提供了引起回送的和暗藏的(underlying)请求对象的有用的元素。
pageLoading Event
[页面正在加载事件]
当确定一个异步回送被服务器端接收后,在页面任何内容被更新前引发。可以使用该事件来为需要更新的内容提供一个定制过渡效果。
该事件需要一个 Sys.WebForms.PageLoadingEventArgs 对象作为 eventargs 参数。该对象提供了最近的异步回送返回的结果关于哪些 panels 会被删除和更新的有用的信息。
pageLoaded Event
[页面加载完成事件]
在页面所有内容被一个同步或异步回送结果刷新之后引发。在同步回送时,panels 只能被创建,但在异步回送时,panels 可以被创建和更新。可以通过使用该事件来管理一个为需要更新的内容定制的变化效果。
该事件需要一个 Sys.WebForms.PageLoadedEventArgs 对象作为 eventargs 参数。该对象提供了关于最近回送时的那些 panels 被更新和创建的有用的信息。
endRequest Event
[结束请求事件]
在响应了完成一个异步回送和页面被更新后,或在请求过程中发生了错误后引发。如果发生了某个错误,页面将不会被更新。通过使用这个事件来提供一个定制的错误提示给访问者或登记到错误日志。
该事件需要一个 Sys.WebForms.EndRequestEventArgs 对象作为 eventargs 参数。该对象提供了有关被引发的错误和错误是否被处理的一些有用的信息。它还提供了有关相应对象的可用的信息。
Event Order Example 【事件顺序的例子】
下面的这个例子展示了在一个存在有两个嵌套的 UpdatePanel 控件的页面的客户端事件将被如何引发。请注意点击父 panel 中的按钮的和内嵌的 panel 中按钮的区别。在父 panel 中的按钮将引起父 panel 的更新,和嵌在其中的 panel 将被删除并重新创建。内嵌 panel 的按钮仅引起内嵌 panel 的更新。
页面代码:
1<%@ Page Language="C#" %>
2
3<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
4 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
5
6<script runat="server">
7
8</script>
9
10<html xmlns="http://www.w3.org/1999/xhtml" >
11<head runat="server">
12 <title>Client Event Example</title>
13 <style type="text/css">
14 #Ou