ASP.NET Global.asax详解

最近在研究bbsmax的代码,但是一直不知道入口在哪里,然后就对各个文件分析了,然后终于在对global.asax文件查看的时候看到Application_BeginRequest才明白入口,所以现在补救下这方面的知识。以下是转载的文档:

文档来源:http://club.topsage.com/thread-485397-1-1.html

global.asax是一个文本文件,它提供全局可用代码。这些代码包括应用程序的事件处理程序以及会话事件、方法和静态变量。有时该文件也被称为应用程序文件。

global.asax 文件中的任何代码都是它所在的应用程序的一部分。每个应用程序在其根目录下只能有一个global.asax文件。然而,这个文件是可选的。如果没有global.asax文件,应用程序将对所有事件应用由 HttpApplication类提供的默认行为。

提示:经典ASP有一个与global.asax类似格式和构造的,名为global.asa的文件。实际上,如果将一个正在运行的global.asa文件代码复制到global.asax中,应用程序同样可以运行。

当应用程序运行的时候,global.asax的内容被编译到一个继承自HttpApplication类的类中。因此,HttpApplication类中所有的方法、类和对象对于应用程序都是可用的。

CLR 监控着global.asax的变化。如果它察觉到这个文件发生了改变,那么将自动启动一个新的应用程序复本,同时创建一个新的应用程序域。原应用程序域当前正在处理的请求被允许结束,而任何新的请求都交由新应用程序域来处理。当原应用程序域的最后一个请求处理完成时,这个应用程序域即被清除。这有效的保证了应用程序可以重新启动,而不被任何用户察觉。

为防止应用程序用户下载应用程序而看到源代码,ASP.NET缺省配置为阻止用户查看global.asax的内容。如果有人在浏览器输入以下URL:

http://localhost/progaspnet/Global.asax

这将会收到一个403(禁止访问)错误信息或者类似的信息如:

This type of page is not served。

提示:简单而言,web.config文件与global.asax有些类似的地方。如果这个文件被更改,应用程序将自动“重启”。同样,也不可能在浏览器中查看web.config文件。

Global.asax文件从外观和结构上与页面文件(.aspx)相似。它可以有一个或多个部分,简要描述如下:

l 指令

l 脚本块

l Object声明

正如Web页和Web服务能够使用代码隐藏功能,global.asax同样也可以。然而,与Web页和Web服务的条件有所不同,VS2005默认状态下不对global.asax使用代码隐藏功能。

提示:Visual Studio 2005预览版默认对global.asax使用代码隐藏模型。目前仍然支持代码隐藏,但不是默认使用。

为了对global.asax使用代码隐藏技术,可使用位于该文件头部的Application指令(类似于页面文件的Page指令,下一节将详细介绍)的Inherits属性,该属性指向global.asax.cs中的代码隐藏类。

同时,也有一个CodeBehind属性用来指向代码隐藏文件。然而,如果它指向的是一个位于App_Code文件夹以外的位置,那么必须对这个类文件进行手动编辑。

通过右键单击解决方案资源管理器中的网站或者单击网站菜单,然后选择“Add New Item...”,接着选择全局应用程序类,可以为Web应用程序添加一个global.asax文件。保留默认名称global.asax。

VS2005将创建一个如示例18-1所列的文件。模板中包括对以下5个事件的空白声明:Application_Start、Application_End、Session_Start、Session_End和Applica- tion_Error。

示例18-1:global.asax模板

< %@ Application Language="C#" %>

在示例18-2所列举的global.asax文件中,为应用程序状态设置了一些值,同时,在每次应用程序启动的时候向日志文件写一个条目。为了使用这个示例,需要保证ASP.NET帐户对根目录c:\具有写入权限(在产品系统中不推荐)。

示例18-2:global.asax示例

< %@ Application  Language="C#"%>

指令

与Web页和Web服务文件相比,global.asax可以以多个指令作为开始。这些指令在处理ASP.NET文件时指定应用程序编译的设置。与Page指令相比,Application指令可

接受一个或者多个具有字典结构的属性/值对。此处支持三个指令:Application、Import和Assembly。

Application  Application指令设置编译器的应用程序专用属性。以下是一个Application指令示例:

< %@ Application  Language="C#" Inherits="WebServiceConsumer.Global"

Description="A sample application" %>

Language 属性可以设置为任何一种标准语言名称:VB、C#、JS、或VJ#,它们分别对应VB2005、C#、JScript.NET或J#。(可以使用任何一种支持.NET平台的第三方语言)默认值为C#。此处的Language设置的是语言专门用于global.asax文件,而非其他应用程序代码文件。例如,可以完全合法地在global.asax文件中使用C#,在.aspx文件中使用VB2005,相反亦然。

Inherits属性指定所继承类名,具有代表性的如代码隐藏文件中的类。

Description属性接受对应用程序的文本描述,而分析器和编译器将会忽略它。

CodeBehind属性在Visual Studio .NET(非VS2005)中用来指定包含的代码隐藏文件。

Import  Import指令仅包括一个Namespace属性。所指定名字空间被明确地导入应用程序中,使其所有的类和接口都可用。导入的名字空间可以是.NET Framework的一部分或者用户自定义的名字空间。

以下是一个典型的Import指令:

< %@ Import Namespace="System.Data" %>

只能有一个Namespace属性。如果需要导入多个名字空间,那么需要使用多个Import指令。

下列名字空间自动导入到所有的Web应用程序中,所以没必要使用Import指令。

l System

l System.Collections

l System.Collections.Specialized

l System.Configuration

l System.IO

l System.Text

l System.Text.RegularExpressions

l System.Web

l System.Web.Caching

l System.Web.Security

l System.Web.SessionState

l System.Web.UI

l System.Web.UI.HtmlControls

l System.Web.UI.WebControls

Assembly  Assembly指令用于在编译过程中将一个程序集链接到当前应用程序。这样可以使所有程序集的类与接口对应用程序都是可用的。

提示:典型的程序集是.dll或.exe文件,这将在下一章中详细讲解。

由于在编译时引用程序集,所以可以使用Assembly指令绑定程序集,然后在运行时将其加载到应用程序池中。

位于应用程序集缓存(也就是位于bin目录和App_Code目录中的代码文件)中的程序集可自动连接到应用程序。因此,任何位于bin目录的程序集,或者由App_Code目录中的代码编译而来的任何程序集,都不需要使用Assembly指令实现连接。

Assembly指令包括两个属性:Name和Src。Name属性是一个字符串,表示连接到应用程序的程序集名字,它不能包含路径。Src属性则是指向源文件的路径(只能为相对路径),这些文件将被动态编译和连接。

每个程序集指令只能有一个属性。如果需要连接多个程序集,则应使用多个Assembly指令。

Assembly指令类似于:

< %@ Assembly %>

< %@ Assembly Src="sources/SomeSourceFile.cs" %>

脚本块

典型的global.asax文件中包含大量代码,这些代码包含在以script标签起止的脚本块中:

如果使用代码隐藏,虽然代码隐藏文件中的代码本身没有附加script标签,但包含在代码隐藏文件中的代码与脚本块中的代码是等效的。

脚本块中的代码可以包含事件处理程序或者方法,下文将对此进行讲解。

事件

如同Web页和控件可以公开事件一样,应用程序中的Application对象和 Session对象也能够公开事件。这些事件能被global.asax文件或指定的文件中的事件处理程序处理。例如,当应用程序开始执行时,触发 Application_Start事件;当应用程序结束时,触发Application_End事件。Application的某些事件是每当页面请求时触发,而其他一些事件,例如Application_Error,则仅在特定情况下触发。

示例18-2中的global.asax文件代码说明了Application_Start 和Application_End事件。示例18-2中的Application_Start事件设置了两个Application属性:一个是名为 strConnectionString的字符串,一个是名为arBooks的字符串数组。事件处理程序方法调用一个名为WriteFile的辅助方法,它包含在global.asax文件中。该辅助方法将一个字符串写入日志文件中。以下是示例18-2中的WriteFile方法代码:

void WriteFile(string strText)

{

System.IO.StreamWriter writer =

new System.IO.StreamWriter(@"C:\test.txt",true);

string str;

str = DateTime.Now.ToString(  ) + "  " + strText;

writer.WriteLine(str);

writer.Close(  );

}

WriteFile 是一个简单的记录日志的方法。该方法初始化一个基于文本文件的 StreamWriter对象,并对c:\test.txt进行硬编码。它在文件中添加了一个时间戳,并写入通过方法传递的字符串。 StreamWriter方法的布尔值参数为true,其表示如果文件已经存在,那么将文本行追加到文件中。如果文件不存在,则创建一个文件。

Application_End事件处理方法调用了另一个WriteFile方法,它添加了一个日志条目以记录应用程序结束。

为了查看这两个事件处理程序的结果,可对global.asax进行一些无意义的编辑,并保存文件。此时将强制结束应用程序。然后请求虚拟目录中的任意URL地址。例如,使用上一章中的一个网页——实际上无论哪一个——或者一个自己创建的网页。示例18-3显示了日志文件内容。

示例18-3:Test.txt摘录

8/26/2006 5:46:23 PM  Application Starting

8/26/2006 6:13:35 PM  Application Ending

8/27/2006 10:17:39 PM  Application Starting

8/27/2006 10:18:23 PM  Application Ending

8/27/2006 10:18:36 PM  Application Starting

如同Application对象的Start和End事件一样,Session对象也拥有Session_ Start和Session_End事件。这将允许应用程序每次启动和结束过程中为每个会话都运行代码。

如示例18-4中高亮显示的方法名所示,其包括了global.asax文件中所有可能的应用程序事件处理程序。在页面请求被接受、处理和呈现过程中,可以容易地查看应用程序生命周期。

示例18-4:Global.asax事件说明

< %@ Application  Language="C#" %>

以下是页面请求触发的所有事件,以触发顺序排序:

Application_BeginRequest

当ASP.NET开始处理每个请求时触发。在这个事件处理中的代码将在页面或者服务处理请求之前执行。

Application_AuthenticateRequest

在验证请求之前触发。(正如第12章介绍的,验证是确认用户就是他所说的那个人的过程)在这个事件处理程序的代码中允许实现自定义安全管道。

Application_AuthorizeRequest

在为请求授权之前触发。(授权是确定是否请求用户具有访问资源的权限的过程,在

第12章已经介绍过)在这个事件处理程序的代码中允许实现自定义安全管道。

Application_ResolveRequestCache

在ASP.NET确定是否应该生成新的输出,或者由缓存填充前触发。无论何种情况,都将执行该事件处理程序中的代码。

Application_AcquireRequestState

在获取会话状态之前执行。

Application_PreRequestHandlerExecute

在将请求发送到服务于请求的处理程序对象之前触发。当事件触发后,页面将由HTTP处理程序处理请求。

Application_PostRequestHandlerExecute

当HTTP处理程序与页面请求一起完成时触发。此时,Response对象将获得由客户端返回的数据。

Application_ReleaseRequestState

当释放和更新试图状态时触发。

Application_UpdateRequestCache

如果输出被缓存,那么缓存更新时将触发。

Application_EndRequest

当请求结束时执行。

Application_PreSendRequestHeaders

在向客户端发送HTTP头之前触发。如果启用响应缓存,这意味着直到所有数据都准备好(默认条件),都不会发送任何数据。该事件总是在Application_EndRequest事件之后。如果禁用响应缓存,那么无论何时将数据发送给客户端,都将触发该事件。响应控制由Page指令的一个属性,或者Web服务的WebMethod属性控制。

Application_PreSendRequestContent

向客户端发送HTTP内容之前触发。和Application_PreSendRequestHeaders事件一样,Application_PreSendRequestContent事件能否被触发取决于响应缓存是否可用。

以下列举应用程序事件,它们在特定条件下触发:

Application_Start

当应用程序启动时触发。当首次请求应用程序虚拟目录中的任何页面时,将启动应用程序,同时如果应用程序已经运行,则不触发该事件。

Application_End

应用程序结束时触发。无论何时修改了配置文件(global.asax、global.asax.cs、

global.asax.vb或者web.config),或者服务器崩溃或者重启,应用程序都将结束。通常在该事件处理程序中执行清除功能的代码,例如关闭数据库连接。

Session_Start

每个会话开始时触发,这是放置具体会话代码的地方。

Session_End

会话结束时触发。它为保存存储在会话中的任何数据提供了机会。

Application_Disposed

当CLR从内存中移除应用程序时触发。

Application_Error

无论在应用程序中何时何处发生未处理的错误都将触发。它提供了一个实现通用应用程序错误处理的好机会。

使用try...catch语句块能够在代码中处理特定错误,也可以使用Page指令的ErrorPage属性来捕获页面级错误。使用这些方式处理任何错误都不会触发Application_Error事件。

为了测试新版的global.asax,在示例18-5中创建一个网页。查看GlobalEvents站点。当该网页运行时,将看到如图18-4所示的页面。

示例18-5:GlobalEvents网站的default.aspx

< %@ Page Language="C#" AutoEventWireup="true"  CodeFile="Default.aspx.cs"

Inherits="_Default" %>

"http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">

Global Events

Text="End Session"

OnClick="btnEndSession_Click" />

Text="Generate Error"

OnClick="btnError_Click" />

ASP.NET Global.asax详解
图18-4:GlobalEvents

如图18-4所示,可看到触发了一系列应用程序事件。在这些事件执行的中途,呈现了.aspx页面自身,接着是另一些应用程序事件。

警告:示例GlobalEvents必须在一个真实的IIS虚拟路径下才能良好运行。

页面第一次显示时触发Session_Start事件,而在随后的显示中则不再触发该事件。 这是因为请求是相同的会话。单击“End Session”按钮,调用Session.Abandon方法,这将结束当前会话。下一次页面被提交到服务器时,将再次触发Session_Start 事件。

Post按钮提供了一个简单的再次提交页面的方法。

示例18-4中大部分的应用程序事件处理程序都使用了Response.Write方法,以便显示触发的事件。然而,Application_Start和Application_End方法调用了WriteFile方法。如果在这些事件处理程序中试图使用Response.Write方法,那么在页面中将不会

显示。因为那时用于呈现的页面会话还没有运行。但是,当检查日志文件c:\test.txt时,将看到应用程序启动和结束所显示的条目。

示例18-4所示的global.asax文件说明了一种使用Application_Error事件的方法。以下列举了这些代码:

protected void Application_Error(Object sender, EventArgs e)

{

string strError;

strError = Server.GetLastError(  ).ToString(  );

if (Context!= null)

Context.ClearError(  );

Response.Write("Application_Error" + "

");

Response.Write("Error Msg: " + strError + "

" +

"End Error Msg

");

}

该事件处理程序使用HttpServerUtility对象的GetLastError方法,以报告最后出现的错误。这个错误被转换为一个字符串,并被指定给一个字符串变量:

strError = Server.GetLastError(  ).ToString(  )

接下来调用HttpContext对象的ClearError方法来清除目前HTTP请求中的所有错误:

Context.ClearError(  )

如果没有将错误清除,那么错误将显示在客户端浏览器,并且还是无法看见Respons- e.Write方法的显示结果。

最后,Response.Write方法显示一个信息,当前的错误将显示在客户端。

另一种向用户报告错误的方式是显示自定义错误处理页面。为此,需要使用以下代码行替代Application_Error事件处理程序中的Response.Write方法:

Response.Redirect("CustomErrorPage.aspx?Msg=" +

Server.UrlEncode(strError));

以上代码行调用HttpServerUtility对象的UrlEncode方法,其将错误信息作为一个QueryString参数传递给CustomErrorPage.aspx页面中的自定义错误处理代码。 CustomErrorPage.aspx页面有一个名为lblMessage的Label控件。以下是页面中的Page_Load方法代码:

void Page_Load(Object Source, EventArgs E)

{
lblMessage.Text = Request.QueryString["Msg"];
}

Default.aspx中的Generate Error按钮故意触发一个错误,以便查看错误处理。该按钮的单击事件处理程序的代码如下所示,它将除零异常:

protected void btnError_Click(object sender, EventArgs e)

{

int a = 5;

int b = 0;

int c;

c = a / b;

}

服务器端包括

使用服务器端包括能够实现在应用程序中包含外部源代码文件。在编译之前,包括文件中的代码将被添加到global.asax文件中。尽管应用程序的语言可能与包括文件的语言不同,但是用于包括文件的语言必须与global.asax文件所使用的语言匹配。

下面是用于服务器端的语法:

在这个句法中,PathType类型可以是表18-1所示之一。

表18-1  PathType属性

路径类型 说  明
File 文件名是包含global.asax文件的目录的相对路径
Virtual 文件名是包含网站虚拟目录的虚拟路径

查看示例18-4所示的global.asax文件,将下面的代码添加到第二行中:

创建一个新的名为IncludeFile.cs的文本文件,将该文件和global.asax存储在同一目录下。这个文件需要与global.asax文件一样的一对脚本标签。

将global.asax页面中的WriteFile方法复制到包括文件中,然后注释(或者删除)global.asax页面中的WriteFile方法。这样包括文件应类似于示例18-6。

示例18-6:具有包括文件的global.asax

如果运行任意一个网页,那么将不会与先前有什么区别,因为您所做的只是把一个文件中的代码转移到另外一个文件中。

如果CLR监视global.asax文件的变化,并和重新启动应用程序一样,CLR也监视包括文件的变化。如果包括文件发生变化,那么应用程序也会重新启动。

对于在多个应用程序中所包括的相同标准代码而言,包括文件非常有用。这些通用代码可能包括数据库访问方法、写入日志记录、错误处理管道、登录或者每个应用程序的基础类型代码片段。

对象声明

在global.asax文件中包括代码的另一个方法是是声明object标签。这些声明的静态对象要么是Application,或者是Session对象。这样就可以在应用程序或者每个会话过程中使用。

上一篇:springboot available: expected at least 1 bean which qualifies as autowire candidate


下一篇:Java & 混型