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: est.txt",true); string str; str = DateTime.Now.ToString( ) + " " + strText; writer.WriteLine(str); writer.Close( ); } WriteFile 是一个简单的记录日志的方法。该方法初始化一个基于文本文件的 StreamWriter对象,并对c: est.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" /> 图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: est.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属性
查看示例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对象。这样就可以在应用程序或者每个会话过程中使用。 |