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)
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
资源
global.asax 文档是 asp.net 应用程式的中央点。他提供无数的事件来处理不同的应用程式级任务,比如用户身份验证、应用程式启动连同处理用户会话等。您应该熟悉这个可选文档,这样就能够构建出健壮的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)
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
资源
global.asax 文档是 asp.net 应用程式的中央点。他提供无数的事件来处理不同的应用程式级任务,比如用户身份验证、应用程式启动连同处理用户会话等。您应该熟悉这个可选文档,这样就能够构建出健壮的asp.net 应用程式。