HttpApplication类的实例的事件
HttpApplication 类的实例是在 ASP.NET 基础结构中创建的,而不是由用户直接创建的。HttpApplication 类的一个实例在其生存期内被用于处理多个请求,但它一次只能处理一个请求。这样,成员变量才可用于存储针对每个请求的数据。
应用程序按照以下顺序执行由 global.asax 文件中定义的模块或用户代码处理的事件:
-
BeginRequest 在 ASP.NET 响应请求时作为 HTTP 执行管线链中的第一个事件发生。
-
AuthenticateRequest 当安全模块已建立用户标识时发生。
-
PostAuthenticateRequest 当安全模块已建立用户标识时发生。
-
AuthorizeRequest 当安全模块已验证用户授权时发生。
-
PostAuthorizeRequest 在当前请求的用户已获授权时发生。
-
ResolveRequestCache 当 ASP.NET 完成授权事件以使缓存模块从缓存中为请求提供服务时发生,从而跳过事件处理程序(例如某个页或 XML Web services)的执行。
-
PostResolveRequestCache 在 ASP.NET 跳过当前事件处理程序的执行并允许缓存模块满足来自缓存的请求时发生。在 PostResolveRequestCache 事件之后、PostMapRequestHandler 事件之前创建一个事件处理程序(对应于请求 URL 的页)。
-
PostMapRequestHandler 在 ASP.NET 已将当前请求映射到相应的事件处理程序时发生。
-
AcquireRequestState 当 ASP.NET 获取与当前请求关联的当前状态(如会话状态)时发生。
-
PostAcquireRequestState 在已获得与当前请求关联的请求状态(例如会话状态)时发生。
-
PreRequestHandlerExecute 恰好在 ASP.NET 开始执行事件处理程序(例如,某页或某个 XML Web service)前发生。 执行事件处理程序。
-
PostRequestHandlerExecute 在 ASP.NET 事件处理程序(例如,某页或某个 XML Web service)执行完毕时发生。
-
ReleaseRequestState 在 ASP.NET 执行完所有请求事件处理程序后发生。该事件将使状态模块保存当前状态数据。
-
PostReleaseRequestState 在 ASP.NET 已完成所有请求事件处理程序的执行并且请求状态数据已存储时发生。 在 PostReleaseRequestState 事件之后,响应筛选器(如果有)将对输出进行筛选。
-
UpdateRequestCache 当 ASP.NET 执行完事件处理程序以使缓存模块存储将用于从缓存为后续请求提供服务的响应时发生。
-
PostUpdateRequestCache 在 ASP.NET 完成了缓存模块的更新并存储了以下响应时发生,这些响应用于满足来自缓存的后续请求。
-
EndRequest 在 ASP.NET 响应请求时作为 HTTP 执行管线链中的最后一个事件发生。
常规页生命周期阶段
一般来说,页要经历下表概述的各个阶段。除了页生命周期阶段以外,还有在请求前后出现的应用程序阶段,但是这些阶段并不特定于页。有关更多信息,请参见 ASP.NET 应用程序生命周期概述。
阶段 | 说明 |
---|---|
页请求 |
页请求发生在页生命周期开始之前。用户请求页时,ASP.NET 将确定是否需要分析和编译页(从而开始页的生命周期),或者是否可以在不运行页的情况下发送页的缓存版本以进行响应。 |
开始 |
在开始阶段,将设置页属性,如 Request 和 Response。在此阶段,页还将确定请求是回发请求还是新请求,并设置 IsPostBack 属性。此外,在开始阶段期间,还将设置页的 UICulture 属性。 |
页初始化 |
页初始化期间,可以使用页中的控件,并将设置每个控件的 UniqueID 属性。此外,任何主题都将应用于页。如果当前请求是回发请求,则回发数据尚未加载,并且控件属性值尚未还原为视图状态中的值。 |
加载 |
加载期间,如果当前请求是回发请求,则将使用从视图状态和控件状态恢复的信息加载控件属性。 |
验证 |
在验证期间,将调用所有验证程序控件的 Validate 方法,此方法将设置各个验证程序控件和页的 IsValid 属性。 |
回发事件处理 |
如果请求是回发请求,则将调用所有事件处理程序。 |
呈现 |
在呈现期间,视图状态将被保存到页,然后页将调用每个控件,以将其呈现的输出提供给页的 Response 属性的 OutputStream。 |
卸载 |
完全呈现页、将页发送至客户端并准备丢弃时,将调用卸载。此时,将卸载页属性(如 Response 和 Request)并执行清理。 |
生命周期事件
在页生命周期的每个阶段中,页将引发可运行您自己的代码进行处理的事件。对于控件事件,通过以声明方式使用属性(如 onclick)或以使用代码的方式,均可将事件处理程序绑定到事件。
页还支持自动事件连接,即,ASP.NET 将寻找具有特定名称的方法,并在引发特定事件时自动运行这些方法。如果 @ Page 指令的 AutoEventWireup 属性设置为 true(或者如果未定义该属性,因为默认情况下为 true),页事件将自动绑定至使用 Page_event 命名约定的方法,如 Page_Load 和 Page_Init。有关自动事件连接的更多信息,请参见 ASP.NET Web 服务器控件事件模型。
下表列出了最常用的页生命周期事件。实际的事件比列出的事件要多。但是,它们不用于大多数页处理方案。而是主要由 ASP.NET 网页上的服务器控件使用,以初始化和呈现它们本身。如果要编写自己的 ASP.NET 服务器控件,则需要详细了解这些阶段。有关创建自定义控件的信息,请参见开发自定义 ASP.NET 服务器控件。
页事件 | 典型使用 | ||
---|---|---|---|
Page_PreInit |
|
||
Page_Init |
|
||
Page_Load |
|
||
Control events |
执行特定于应用程序的处理: |
||
Page_PreRender |
|
||
Page_Unload |
执行最后的清理工作,可能包括:
|
1 using System.Data;
2 using System.Configuration;
3 using System.Web;
4 using System.Web.Security;
5 using System.Web.UI;
6 using System.Web.UI.WebControls;
7 using System.Web.UI.WebControls.WebParts;
8 using System.Web.UI.HtmlControls;
9
10 public partial class _Default : Page
11 {
12 #region OnPreInit 第一步
13 protected override void OnPreInit(EventArgs e)
14 {
15 //检查 IsPostBack 属性来确定是不是第一次处理该页。
16 //创建或重新创建动态控件。
17 //动态设置主控页。
18 //动态设置 Theme 属性。
19 //读取或设置配置文件属性值。
20 //注意
21 //如果请求是回发请求,则控件的值尚未从视图状态还原。如果在此阶段设置控件属性,则其值可能会在下一事件中被重写。
22 base.OnPreInit(e);
23 }
24 #endregion
25
26 #region OnInit 第二步
27 protected override void OnInit(EventArgs e)
28 {
29 //在所有控件都已初始化且已应用所有外观设置后引发。使用该事件来读取或初始化控件属性。
30 base.OnInit(e);
31 }
32 #endregion
33
34 #region OnInitComplete 第三步
35 protected override void OnInitComplete(EventArgs e)
36 {
37 //由 Page 对象引发。使用该事件来处理要求先完成所有初始化工作的任务。
38
39 base.OnInitComplete(e);
40 }
41 #endregion
42
43 #region PreLoad 第四步
44 protected override void OnPreLoad(EventArgs e)
45 {
46 //html服务器控件的值在次恢复(值已经恢复)
47 //如果需要在 Load 事件之前对页或控件执行处理,请使用该事件。
48 //在 Page 引发该事件后,它会为自身和所有控件加载视图状态,然后会处理 Request 实例包括的任何回发数据。
49 base.OnPreLoad(e);
50 }
51 #endregion
52
53 #region OnLoad 第五步
54 protected override void OnLoad(EventArgs e)
55 {
56 //Page 在 Page 上调用 OnLoad 事件方法,然后以递归方式对每个子控件执行相同操作,
57 //如此循环往复,直到加载完本页和所有控件为止。
58 //使用 OnLoad 事件方法来设置控件中的属性并建立数据库连接。
59 base.OnLoad(e);
60 }
61 #endregion
62
63 #region 第六步
64 protected void Page_Load(object sender, EventArgs e)
65 {
66 //这个还要我说什么么?地球人都知道
67 //执行完之后,再执行用户控件的Page_Load()事件
68 }
69 #endregion
70
71 #region 控件事件 第七步
72 protected void Button1_Click(object sender, EventArgs e)
73 {
74 //用这些事件来处理特定控件事件,如 Button 控件的 Click 事件或 TextBox 控件的 TextChanged 事件。
75 //注意
76 //在回发请求中,如果页包含验证程序控件,请在执行任何处理之前检查 Page 和各个验证控件的 IsValid 属性。
77 }
78 #endregion
79
80 #region OnLoadComplete 第八步
81 protected override void OnLoadComplete(EventArgs e)
82 {
83 //对需要加载页上的所有其他控件的任务使用该事件。
84
85 base.OnLoadComplete(e);
86 }
87 #endregion
88
89 #region OnPreRender 第九步
90 protected override void OnPreRender(EventArgs e)
91 {
92 //在该事件发生前:
93 //Page 对象会针对每个控件和页调用 EnsureChildControls。
94 //设置了 DataSourceID 属性的每个数据绑定控件会调用 DataBind 方法。
95 //有关更多信息,请参见下面的数据绑定控件的数据绑定事件。
96 //页上的每个控件都会发生 PreRender 事件。使用该事件对页或其控件的内容进行最后更改。
97
98 base.OnPreRender(e);
99 }
100 #endregion
101
102 #region SaveStateComplete 第十步
103 protected override void OnSaveStateComplete(EventArgs e)
104 {
105 //在该事件发生前,已针对页和所有控件保存了 ViewState。将忽略此时对页或控件进行的任何更改。
106 //使用该事件执行满足以下条件的任务:要求已经保存了视图状态,但未对控件进行任何更改。
107
108 base.OnSaveStateComplete(e);
109 }
110 #endregion
111
112 #region Render 第十一步
113 //Render
114 //这不是事件;在处理的这个阶段,Page 对象会在每个控件上调用此方法。
115 //所有 ASP.NET Web 服务器控件都有一个用于写出发送给浏览器的控件标记的 Render 方法。
116 //如果创建自定义控件,通常要重写此方法以输出控件的标记。
117 //不过,如果自定义控件只合并标准的 ASP.NET Web 服务器控件,不合并自定义标记,则不需要重写 Render 方法。
118 //有关更多信息,请参见开发自定义 ASP.NET 服务器控件。
119 //用户控件(.ascx 文件)自动合并呈现,因此不需要在代码中显式呈现该控件。
120
121 #endregion
122
123 #region OnUnload 第十二步
124 protected override void OnUnload(EventArgs e)
125 {
126 //该事件首先针对每个控件发生,继而针对该页发生。在控件中,使用该事件对特定控件执行最后清理,
127 //如关闭控件特定数据库连接。
128 //对于页自身,使用该事件来执行最后清理工作,如:关闭打开的文件和数据库连接,或完成日志记录或其他请求特定任务。
129 //注意
130 //在卸载阶段,页及其控件已被呈现,因此无法对响应流做进一步更改。
131 //如果尝试调用方法(如 Response.Write 方法),则该页将引发异常。
132
133
134 base.OnUnload(e);
135 }
136 #endregion
137 }
母版页和内容页的执行顺序:
母版页中控件的Init->内容页控件的Init->母版页的Init->内容页的Init
->内容页的Load->母版页的Load->内容页中控件的Load
->内容页的PreRender->母版页的PreRender->母版页控件的PreRender->内容页中控件的PreRender
其他的页生命周期注意事项
请注意有关页生命周期的以下附加信息:
-
各个 ASP.NET 服务器控件都有自己的生命周期,该生命周期与页生命周期类似。例如,在相应的页事件期间将调用控件的 Init 和 Load 方法。如果页上包含控件,则将首先调用控件的 Init 方法,然后再调用页的 Init 方法。但是,将在调用控件的 Load 方法之前先调用页的 Load 方法。
-
通过处理控件的事件,可以自定义控件的外观或内容。例如,所有的控件都将引发 Init、Load 和 Unload 事件,但是页开发人员通常不处理这些事件。而是通常处理特定于控件的事件,如 Button 控件的 Click 事件和 ListBox 控件的 SelectedIndexChanged 事件。在某些情况下,可能也需处理控件的 DataBinding 或 DataBound 事件。有关更多信息,请参见各个控件的类参考主题以及开发自定义 ASP.NET 服务器控件。
-
除了处理由页引发的事件以外,还可以重写页的基类中的方法。例如,可以重写页的 InitializeCulture 方法,以便动态设置区域性信息。注意,在使用 Page_event 语法创建事件处理程序时,将隐式调用基实现,因此无需在方法中调用它。例如,无论是否创建 Page_Load 方法,始终都会调用页基类的 OnLoad 方法。但是,如果使用 override 关键字(在 Visual Basic 中为 Overrides)重写页的 OnLoad 方法,则必须显式调用基方法。例如,如果在页中重写 OnLoad 方法,则必须调用 base.Load(在 Visual Basic 中为 MyBase.Load)以运行基实现。