The Global.asax file, sometimes called the
ASP.NET application file, provides a way to respond to application
or module level events in one central location. You can use this
file to implement application security, as well as other tasks.
Let’s take a closer look at how you may use it in your application
development efforts.
Overview
The Global.asax file is in the root application
directory. While Visual Studio .NET automatically inserts it in all
new ASP.NET projects, it’s actually an optional file. It’s okay to
delete it—if you aren’t using it. The .asax file extension signals
that it’s an application file rather than an ASP.NET file that uses
aspx.
The Global.asax file is configured so that any
direct HTTP request (via URL) is rejected automatically, so users
cannot download or view its contents. The ASP.NET page framework
recognizes automatically any changes that are made to the
Global.asax file. The framework reboots the application, which
includes closing all browser sessions, flushes all state
information, and restarts the application domain.
Programming
The Global.asax file, which is derived from the
HttpApplication class, maintains a pool of HttpApplication objects,
and assigns them to applications as needed. The Global.asax file
contains the following events:
-
Application_Init: Fired when an application initializes or is first
called. It’s invoked for all HttpApplication object instances. -
Application_Disposed: Fired just before an application is
destroyed. This is the ideal location for cleaning up previously
used resources. -
Application_Error: Fired when an unhandled exception is encountered
within the application. -
Application_Start: Fired when the first instance of the
HttpApplication class is created. It allows you to create objects
that are accessible by all HttpApplication instances. -
Application_End: Fired when the last instance of an HttpApplication
class is destroyed. It’s fired only once during an application’s
lifetime. -
Application_BeginRequest: Fired when an application request is
received. It’s the first event fired for a request, which is often
a page request (URL) that a user enters. -
Application_EndRequest: The last event fired for an application
request. -
Application_PreRequestHandlerExecute: Fired before the ASP.NET page
framework begins executing an event handler like a page or Web
service. -
Application_PostRequestHandlerExecute: Fired when the ASP.NET page
framework is finished executing an event handler. -
Applcation_PreSendRequestHeaders: Fired before the ASP.NET page
framework sends HTTP headers to a requesting client (browser). -
Application_PreSendContent: Fired before the ASP.NET page framework
sends content to a requesting client (browser). -
Application_AcquireRequestState: Fired when the ASP.NET page
framework gets the current state (Session state) related to the
current request. -
Application_ReleaseRequestState: Fired when the ASP.NET page
framework completes execution of all event handlers. This results
in all state modules to save their current state data. -
Application_ResolveRequestCache: Fired when the ASP.NET page
framework completes an authorization request. It allows caching
modules to serve the request from the cache, thus bypassing handler
execution. -
Application_UpdateRequestCache: Fired when the ASP.NET page
framework completes handler execution to allow caching modules to
store responses to be used to handle subsequent requests. -
Application_AuthenticateRequest: Fired when the security module has
established the current user’s identity as valid. At this point,
the user’s credentials have been validated. -
Application_AuthorizeRequest: Fired when the security module has
verified that a user can access resources. -
Session_Start: Fired when a new user visits the application Web
site. -
Session_End: Fired when a user’s session times out, ends, or they
leave the application Web site.
The event list may seem daunting, but it can be
useful in various circumstances.
A key issue with taking advantage of the events
is knowing the order in which they’re triggered. The
Application_Init and Application_Start events are fired once when
the application is first started. Likewise, the
Application_Disposed and Application_End are only fired once when
the application terminates. In addition, the session-based events
(Session_Start and Session_End) are only used when users enter and
leave the site. The remaining events deal with application
requests, and they’re triggered in the following order:
- Application_BeginRequest
- Application_AuthenticateRequest
- Application_AuthorizeRequest
- Application_ResolveRequestCache
- Application_AcquireRequestState
- Application_PreRequestHandlerExecute
- Application_PreSendRequestHeaders
- Application_PreSendRequestContent
- <<code is executed>>
- Application_PostRequestHandlerExecute
- Application_ReleaseRequestState
- Application_UpdateRequestCache
- Application_EndRequest
A common use of some of these events is
security. The following C# example demonstrates various Global.asax
events with the Application_Authenticate event used to facilitate
forms-based authentication via a cookie. In addition, the
Application_Start event populates an application variable, while
Session_Start populates a session variable. The Application_Error
event displays a simple message stating an error has occurred.
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.”);
}
This example provides a peek at the usefulness
of the events contained in the Global.asax file; it’s important to
realize that these events are related to the entire application.
Consequently, any methods placed in it are available through the
application’s code, hence the Global name.
Here’s the VB.NET equivalent of the previous
code:
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)
Catch ex As Exception
‘ Log exception details (omitted for simplicity)
Return
End Try
Dim roles(2) As String
roles(0) = “One”
roles(1) = “Two”
Dim id As FormsIdentity
id = New FormsIdentity(authTicket)
Dim principal As GenericPrincipal
principal = New GenericPrincipal(id, roles)
‘ Attach the new principal object to the current HttpContext
object
Context.User = principal
End Sub
Sub Application_Error(ByVal sender As Object, ByVal e As
EventArgs)
Response.Write(“Error encountered.”)
End Sub
A good resource
The Global.asax file is the central point for
ASP.NET applications. It provides numerous events to handle various
application-wide tasks such as user authentication, application
start up, and dealing with user sessions. You should be familiar
with this optional file to build robust ASP.NET-based
applications.
TechRepublic’s free .NET newsletter, delivered each Wednesday, contains useful tips and coding examples on topics such as Web services, ASP.NET, ADO.NET, and Visual Studio .NET. Automatically sign up today!