Global.asax 文件,有時候叫做 ASP.NET 應用程序文件,提供了一種在一個中心位置響應應用程序級或模塊級事件的方法。你可以使用這個文件實現應用程序安全性以及其它一些任務。下面讓我們詳細看一下如何在應用程序開發工作中使用這個文件。
概述
Global.asax 位於應用程序根目錄下。雖然 Visual Studio .NET 會自動插入這個文件到所有的 ASP.NET 項目中,但是它實際上是一個可選文件。刪除它不會出問題——當然是在你沒有使用它的情況下。.asax 文件擴展名指出它是一個應用程序文件,而不是一個使用 aspx 的 ASP.NET 文件。
Global.asax 文件被配置為任何(通過 URL 的)直接 HTTP 請求都被自動拒絕,所以用戶不能下載或查看其內容。ASP.NET 頁面框架能夠自動識別出對Global.asax 文件所做的任何更改。在 Global.asax 被更改後ASP.NET 頁面框架會重新啟動應用程序,包括關閉所有的浏覽器會話,去除所有狀態信息,並重新啟動應用程序域。
編程
Global.asax 文件繼承自HttpApplication 類,它維護一個HttpApplication 對象池,並在需要時將對象池中的對象分配給應用程序。Global.asax 文件包含以下事件:
·Application_Init:在應用程序被實例化或第一次被調用時,該事件被觸發。對於所有的HttpApplication 對象實例,它都會被調用。
·Application_Disposed:在應用程序被銷毀之前觸發。這是清除以前所用資源的理想位置。
·Application_Error:當應用程序中遇到一個未處理的異常時,該事件被觸發。
·Application_Start:在HttpApplication 類的第一個實例被創建時,該事件被觸發。它允許你創建可以由所有HttpApplication 實例訪問的對象。
·Application_End:在HttpApplication 類的最後一個實例被銷毀時,該事件被觸發。在一個應用程序的生命周期內它只被觸發一次。
·Application_BeginRequest:在接收到一個應用程序請求時觸發。對於一個請求來說,它是第一個被觸發的事件,請求一般是用戶輸入的一個頁面請求(URL)。
·Application_EndRequest:針對應用程序請求的最後一個事件。
·Application_PreRequestHandlerExecute:在 ASP.NET 頁面框架開始執行諸如頁面或 Web 服務之類的事件處理程序之前,該事件被觸發。
·Application_PostRequestHandlerExecute:在 ASP.NET 頁面框架結束執行一個事件處理程序時,該事件被觸發。
·Applcation_PreSendRequestHeaders:在 ASP.NET 頁面框架發送 HTTP 頭給請求客戶(浏覽器)時,該事件被觸發。
·Application_PreSendContent:在 ASP.NET 頁面框架發送內容給請求客戶(浏覽器)時,該事件被觸發。
·Application_AcquireRequestState:在 ASP.NET 頁面框架得到與當前請求相關的當前狀態(Session 狀態)時,該事件被觸發。
·Application_ReleaseRequestState:在 ASP.NET 頁面框架執行完所有的事件處理程序時,該事件被觸發。這將導致所有的狀態模塊保存它們當前的狀態數據。
·Application_ResolveRequestCache:在 ASP.NET 頁面框架完成一個授權請求時,該事件被觸發。它允許緩存模塊從緩存中為請求提供服務,從而繞過事件處理程序的執行。
·Application_UpdateRequestCache:在 ASP.NET 頁面框架完成事件處理程序的執行時,該事件被觸發,從而使緩存模塊存儲響應數據,以供響應後續的請求時使用。
·Application_AuthenticateRequest:在安全模塊建立起當前用戶的有效的身份時,該事件被觸發。在這個時候,用戶的憑據將會被驗證。
·Application_AuthorizeRequest:當安全模塊確認一個用戶可以訪問資源之後,該事件被觸發。
·Session_Start:在一個新用戶訪問應用程序 Web 站點時,該事件被觸發。
·Session_End:在一個用戶的會話超時、結束或他們離開應用程序 Web 站點時,該事件被觸發。
這個事件列表看起來好像多得嚇人,但是在不同環境下這些事件可能會非常有用。
使用這些事件的一個關鍵問題是知道它們被觸發的順序。Application_Init 和Application_Start 事件在應用程序第一次啟動時被觸發一次。相似地,Application_Disposed 和 Application_End 事件在應用程序終止時被觸發一次。此外,基於會話的事件(Session_Start 和 Session_End)只在用戶進入和離開站點時被使用。其余的事件則處理應用程序請求,這些事件被觸發的順序是:
·Application_BeginRequest
·Application_AuthenticateRequest
·Application_AuthorizeRequest
·Application_ResolveRequestCache
·Application_AcquireRequestState
·Application_PreRequestHandlerExecute
·Application_PreSendRequestHeaders
·Application_PreSendRequestContent
·<<執行代碼>>
·Application_PostRequestHandlerExecute
·Application_ReleaseRequestState
·Application_UpdateRequestCache
·Application_EndRequest
這些事件常被用於安全性方面。下面這個 C# 的例子演示了不同的Global.asax 事件,該例使用Application_Authenticate 事件來完成通過 cookie 的基於表單(form)的身份驗證。此外,Application_Start 事件填充一個應用程序變量,而Session_Start 填充一個會話變量。Application_Error 事件顯示一個簡單的消息用以說明發生的錯誤。
protected void Application_Start(Object sender, EventArgs e) {
Application["Title"] = "Builder.com Sample";
}
protected void Session_Start(Object sender, EventArgs e) {
Session["startValue"] = 0;
}
protected void Application_AuthenticateRequest(Object sender, EventArgs e) {
// Extract the forms authentication cookie
string cookieName = FormsAuthentication.FormsCookieName;
HttpCookie authCookie = Context.Request.Cookies[cookieName];
if(null == authCookie) {
// There is no authentication cookie.
return;
}
FormsAuthenticationTicket authTicket = null;
try {
authTicket = FormsAuthentication.Decrypt(authCookie.Value);
} catch(Exception ex) {
// Log exception details (omitted for simplicity)
return;
}
if (null == authTicket) {
// Cookie failed to decrypt.
return;
}
// When the ticket was created, the UserData property was assigned
// a pipe delimited string of role names.
string[2] roles
roles[0] = "One"
roles[1] = "Two"
// Create an Identity object
FormsIdentity id = new FormsIdentity( authTicket );
// This principal will flow throughout the request.
GenericPrincipal principal = new GenericPrincipal(id, roles);
// Attach the new principal object to the current HttpContext object
Context.User = principal;
}
protected void Application_Error(Object sender, EventArgs e) {
Response.Write("Error encountered.");
}
這個例子只是很簡單地使用了一些Global.asax 文件中的事件;重要的是要意識到這些事件是與整個應用程序相關的。這樣,所有放在其中的方法都會通過應用程序的代碼被提供,這就是它的名字為Global 的原因。
這裡是前面的例子相應的 VB.NET 代碼:
Sub Application_Start(ByVal sender As Object, ByVal e As EventArgs)
Application("Title") = "Builder.com Sample"
End Sub
Sub Session_Start(ByVal sender As Object, ByVal e As EventArgs)
Session("startValue") = 0
End Sub
Sub Application_AuthenticateRequest(ByVal sender As Object, ByVal e As
EventArgs)
’ Extract the forms authentication cookie
Dim cookieName As String
cookieName = FormsAuthentication.FormsCookieName
Dim authCookie As HttpCookie
authCookie = Context.Request.Cookies(cookieName)
If (authCookie Is Nothing) Then
’ There is no authentication cookie.
Return
End If
Dim authTicket As FormsAuthenticationTicket
authTicket = Nothing
Try
authTicket = FormsAuthentication.Decrypt(authCookie.Value)