关于上下文
Microsoft Corporation
2002年1月14日
编写 Web 应用程序时最常见的问题之一，是要让代码知道它的执行上下文。让我们通过一个简单的例子（即个性化页面）来说明这个问题：
请登录。
与
欢迎 Susan！
虽然看起来很简单，但即使是这一小段 Web UI，仍然需要好几段信息，而且每次请求该页时这些信息都会发生变化。我们需要知道以下内容：
- 用户登录了吗？
- 用户的显示名是什么？
更通常的问题是，每次请求该页时，唯一的上下文是什么？以及如何编写代码以便能考虑到此信息？
事实上，由于 HTTP 的无状态特性，Web 应用程序可能需要跟踪许多不同的上下文片段。当用户与 Web 应用程序交互时，浏览器将一系列独立的 HTTP 请求发送到 Web 服务器。应用程序自身必须将这些请求组织成令用户感到愉悦的体验；同时，知道请求的上下文也十分关键。
ASP 引入了几个内部对象，如 Request 和 Application，以便帮助跟踪 HTTP 请求的上下文。ASP.NET 完成下一步骤，并将这些对象以及其他几个与上下文有关的对象捆绑在一起，形成一个极为方便的内部对象 Context。
Context 是 System.Web.HttpContext（英文）类型的对象。它作为 ASP.NET Page 类的属性公开。也可以通过用户控件和业务对象（下文中详细介绍）获得该对象。以下是 HttpContext 形成的对象的部分列表：
| 对象 | 说明 |
|---|---|
| Application | 值的关键字/值对集合，可由应用程序的每个用户访问。Application 是 System.Web.HttpApplicationState 类型。 |
| ApplicationInstance | 实际运行的应用程序，它公开一些请求处理事件。这些事件在 Global.asax、HttpHandler 或 HttpModule 中处理。 |
| Cache | ASP.NET Cache 对象，它提供对缓存的编程访问。Rob Howard 的 ASP.NET Caching 专栏（英文）对缓存作了详尽介绍。 |
| Error | 处理页时遇到的第一个错误（如果有）。有关详细信息，请参阅 Rob 撰写的 Exception to the Rule, Part 1（英文）。 |
| Items | 关键字/值对集合，可以用来在参与处理同一请求的所有组件之间传递信息。Items 是 System.Collections.IDictionary 类型。 |
| Request | 有关 HTTP 请求的信息，包括浏览器信息、Cookies 以及在窗体或查询字符串中传递的值。Request 是 System.Web.HttpRequest 类型。 |
| Response | 用于创建 HTTP 响应的设置和内容。Response 是 System.Web.HttpResponse 类型。 |
| Server | 服务器是一个实用程序类，带有一些有用的帮助器方法，包括 Server.Execute()、Server.MapPath() 和 Server.HtmlEncode()。Server 是 System.Web.HttpServerUtility 类型的对象。 |
| Session | 值的关键字/值对集合，可由应用程序的单个用户访问。Session 是 System.Web.HttpSessionState 类型。 |
| Trace | ASP.NET 的 Trace 对象，提供对跟踪功能的访问。有关详细信息，请参阅 Rob 撰写的文章 Tracing（英文）。 |
| User | 当前用户（如果已经过身份验证）的安全上下文。Context.User.Identity 是用户的名称。User 是 System.Security.Principle.IPrincipal 类型的对象。 |
如果您是一位 ASP 开发人员，那么对上面讲述的部分对象应不会感到陌生。虽然有一些改进，但大体而言，它们在 ASP.NET 中的作用与在 ASP 中是完全一样的。
Context 基础知识
Context 中的部分对象也已升级为 Page 中的顶级对象。例如，Page.Context.Response 和 Page.Response 指的是同一个对象，因此，以下代码是等价的：
[Visual Basic® Web 窗体]
Response.Write ("您好") Context.Response.Write ("你好")
[C# Web 窗体]
Response.Write ("您好"); Context.Response.Write ("你好");
还可以从业务对象使用 Context 对象。HttpContext.Current 是静态属性，可以很方便地返回当前请求的上下文。这在各种方法中都十分有用，下面仅列举一个从业务类的缓存中检索项目的简单示例：
[Visual Basic]
' 获取请求上下文 Dim _context As HttpContext = HttpContext.Current ' 获取缓存中的数据集 Dim _data As DataSet = _context.Cache("MyDataSet")
[C#]
// 获取请求上下文 HttpContext _context = HttpContext.Current; // 获取缓存中的数据集 DataSet _data = _context.Cache("MyDataSet");
操作中的 Context
Context 对象为一些常见的 ASP.NET“如何…？”问题提供了答案。也许，说明此宝贵对象的价值的最好方法，就是在操作中将它展示出来。下面是一些我所知道的最巧妙的 Context 技巧。
我如何从自己的业务类中生成 ASP.NET 跟踪语句？
回答：很简单！使用 HttpContext.Current 获取 Context 对象，然后调用 Context.Trace.Write()。
[Visual Basic]
Imports SystemImports System.WebNamespace Context ' 演示从业务类中生成一个 ASP.NET ' 跟踪语句。 Public Class TraceEmit Public Sub SomeMethod() ' 获取请求上下文 Dim _context As HttpContext = HttpContext.Current ' 使用上下文编写跟踪语句 _context.Trace.Write("在 TraceEmit.SomeMethod 中") End Sub End ClassEnd Namespace
[C#]
using System;using System.Web;namespace Context{ // 演示从业务类中生成一个 ASP.NET // 跟踪语句。 public class TraceEmit { public void SomeMethod() { // 获取请求上下文 HttpContext _context = HttpContext.Current; // 使用上下文编写跟踪语句 _context.Trace.Write("在 TraceEmit.SomeMethod 中"); } }}
如何才能从业务类中访问会话状态值？
回答：很简单！使用 HttpContext.Current 获取 Context 对象，然后访问 Context.Session。
[Visual Basic]
Imports SystemImports System.WebNamespace Context ' 演示从业务类中访问 ASP.NET 内部 ' 会话。 Public Class UseSession Public Sub SomeMethod() ' 获取请求上下文 Dim _context As HttpContext = HttpContext.Current ' 访问内部会话 Dim _value As Object = _context.Session("TheValue") End Sub End ClassEnd Namespace
[C#]
using System;using System.Web;namespace Context{ // 演示从业务类中访问 ASP.NET 内部 // 会话 public class UseSession { public void SomeMethod() { // 获取请求上下文 HttpContext _context = HttpContext.Current; // 访问内部会话 object _value = _context.Session["TheValue"]; } }}
如何才能在应用程序的每页中添加标准页眉和页脚？
回答：处理应用程序的 BeginRequest 和 EndRequest 事件，并使用 Context.Response.Write 生成页眉和页脚的 HTML。
从技术上讲，可以在 HttpModule 中或通过使用 Global.asax 处理 BeginRequest 这样的应用程序。HttpModules 的编写比较困难，而且正如本例所示，简单应用程序使用的功能通常不使用它。因此，我们使用应用程序范围的 Global.asax 文件。
与 ASP 页一样，一些固有的 ASP.NET 上下文已提升为 HttpApplication 类的属性，其中的类表示 Global.asax 继承类。我们不需要使用 HttpContext.Current 获取对 Context 对象的引用；它在 Global.asax. 中已可用。
本例中，我将 <html> 和 <body> 标记以及一条水平线放入页眉部分，而将另一条水平线及相应的结束标记放入页脚部分。页脚还包含版权消息。运行结果应如下图所示：
图 1：浏览器中呈现的标准页眉和页脚示例
这是一个简单的示例，但您可以很容易地将它扩展，使其包含标准的页眉与导航，或者仅输出相应的 <!-- #include ---> 语句。请注意，如果希望页眉或页脚包含交互内容，应考虑使用 ASP.NET 用户控件。
[SomePage.aspx 源代码 - 内容示例]
<FONT face="Arial" color="#cc66cc" size="5">常规页面内容</FONT>
[Visual Basic Global.asax]
<%@ Application Language="VB" %><script runat="server"> Sub Application_BeginRequest(sender As Object, e As EventArgs) ' 生成页眉 Context.Response.Write("<html>" + ControlChars.Lf + _"<body bgcolor=#efefef>" + ControlChars.Lf + "<hr>" + _ ControlChars.Lf) End Sub Sub Application_EndRequest(sender As Object, e As EventArgs) ' 生成页脚 Context.Response.Write("<hr>" + ControlChars.Lf + _ "2002 Microsoft Corporation 版权所有" + _ ControlChars.Lf + "</body>" + ControlChars.Lf + "</html>") End Sub </script>
[C# Global.asax]
<%@ Application Language="C#" %><script runat="server"> void Application_BeginRequest(Object sender, EventArgs e) { // 生成页眉 Context.Response.Write("<html>/n<body bgcolor=#efefef>/n<hr>/n"); } void Application_EndRequest(Object sender, EventArgs e) { // 生成页脚 Context.Response.Write("<hr>/2002 Microsoft Corporation 版权所有/n"); Context.Response.Write("</body>/n</html>"); }</script>
如何在用户经过身份验证后显示欢迎信息？
回答：测试 User 上下文对象以查看用户是否经过身份验证。如果是，还要从 User 对象获取用户名。当然，这是本文开头的示例。
[Visual Basic]
<script language="VB" runat="server"> Sub Page_Load(sender As Object, e As EventArgs) { If User.Identity.IsAuthenticated Then welcome.Text = "欢迎" + User.Identity.Name Else ' 尚未登录，添加一个指向登录页的链接 welcome.Text = "请登录！" welcome.NavigateUrl = "signin.aspx" End If End Sub</script><asp:HyperLink id="welcome" runat="server" maintainstate="false"></asp:HyperLink>
[C#]
<script language="C#" runat="server"> void Page_Load(object sender, EventArgs e) { if (User.Identity.IsAuthenticated) { welcome.Text = "欢迎" + User.Identity.Name; } else { // 尚未登录，添加一个指向登录页的链接 welcome.Text = "请登录！"; welcome.NavigateUrl = "signin.aspx"; } }</script><asp:HyperLink id="welcome" runat="server" maintainstate="false"></asp:HyperLink>
Context.Items 简介
希望以上示例可以说明，使用手头仅有的上下文信息编写 Web 应用程序是多么容易。那么，如果可以用同样的方法访问您应用程序独有的一些上下文，不是很好吗？
这就是 Context.Items 集合的用途。它使用在参与处理请求的各部分代码中都可用的方法，保存应用程序的请求特有值。例如，同样一条信息可以用在 Global.asax、ASPX 页、页内的用户控件中，也可以由页调用的业务逻辑使用。
请考虑 IBuySpy Portal（英文）应用程序示例。它使用一个简单的主页 DesktopDefault.aspx 来显示门户内容。显示的内容取决于所选择的选项卡，以及用户（如果已经过身份验证）角色。
图 2：IbuySpy 主页
查询字符串包含正被请求的选项卡的 TabIndedx 和 TabId 参数。在处理请求的整个过程中，一直使用此信息筛选要显示给用户的数据。http://www.ibuyspyportal.com/DesktopDefault.aspx?tabindex=1&tabid=2（英文）
要使用查询字符串值，需要首先确保它是一个有效值，如果不是，则要进行一些错误处理。它并不是一大串代码，但是您真的要在每个使用该值的页和组件中复制它吗？当然不！在 Portal 示例中，甚至更多的地方都涉及到它，因为一旦我们知道了 TabId，就可以预先加载其他信息。
Portal 使用查询字符串值作为参数，以构造一个新的 PortalSettings 对象，并将它添加到 Global.asax 的 BeginRequest 事件的 Context.Items 中。由于在每个请求开始处都执行了开始请求，这使得与该选项卡有关的值在应用程序的所有页和组件中都可用。请求完成后，对象将被自动丢弃 - 非常整齐！
[Visual Basic Global.asax]
Sub Application_BeginRequest(sender As [Object], e As EventArgs) Dim tabIndex As Integer = 0 Dim tabId As Integer = 0 ' 从查询字符串获取 TabIndex If Not (Request.Params("tabindex") Is Nothing) Then tabIndex = Int32.Parse(Request.Params("tabindex")) End If ' 从查询字符串获取 TabID If Not (Request.Params("tabid") Is Nothing) Then tabId = Int32.Parse(Request.Params("tabid")) End If Context.Items.Add("PortalSettings", _New PortalSettings(tabIndex, tabId)) End Sub
[C# Global.asax]
void Application_BeginRequest(Object sender, EventArgs e) { int tabIndex = 0; int tabId = 0; // 从查询字符串获取 TabIndex if (Request.Params["tabindex"] != null) { tabIndex = Int32.Parse(Request.Params["tabindex"]); } // 从查询字符串获取 TabID if (Request.Params["tabid"] != null) { tabId = Int32.Parse(Request.Params["tabid"]); } Context.Items.Add("PortalSettings", new PortalSettings(tabIndex, tabId));}
DesktopPortalBanner.ascx 用户控件从 Context 请求 PortalSetting 的对象，以访问 Portal 的名称和安全设置。事实上，此模块是操作中的 Context 的一个典型综合示例。为阐明这一点，我已将代码进行了一些简化，并用粗体标记了 HTTP 或应用程序特定的 Context 被访问过的所有地方。
[C# DesktopPortalBanner.ascx]
<%@ Import Namespace="ASPNetPortal" %><%@ Import Namespace="System.Data.SqlClient" %><script language="C#" runat="server"> public int tabIndex; public bool ShowTabs = true; protected String LogoffLink = ""; void Page_Load(Object sender, EventArgs e) { // 从当前上下文获取 PortalSettings PortalSettings portalSettings = (PortalSettings) Context.Items["PortalSettings"]; // 动态填充门户站点名称 siteName.Text = portalSettings.PortalName; // 如果用户已登录，自定义欢迎信息 if (Request.IsAuthenticated == true) { WelcomeMessage.Text = "欢迎" + Context.User.Identity.Name + "！<" + "span class=Accent" + ">|<" + "/span" + ">"; // 如果身份验证模式为 Cookie，则提供一个注销链接 if (Context.User.Identity.AuthenticationType == "Forms") { LogoffLink = "<" + "span class=/"Accent/">|</span>/n" + "<a href=" + Request.ApplicationPath + "/Admin/Logoff.aspx class=SiteLink> 注销" + "</a>"; } } // 动态显示门户选项卡条 if (ShowTabs == true) { tabIndex = portalSettings.ActiveTab.TabIndex; // 生成要向用户显示的选项卡列表 ArrayList authorizedTabs = new ArrayList(); int addedTabs = 0; for (int i=0; i < portalSettings.DesktopTabs.Count; i++) { TabStripDetails tab = (TabStripDetails)portalSettings.DesktopTabs[i]; if (PortalSecurity.IsInRoles(tab.AuthorizedRoles)) { authorizedTabs.Add(tab); } if (addedTabs == tabIndex) { tabs.SelectedIndex = addedTabs; } addedTabs++; } // 用已授权的选项卡填充页顶部的选项卡// 列表 tabs.DataSource = authorizedTabs; tabs.DataBind(); } }</script><table width="100%" cellspacing="0" class="HeadBg" border="0"> <tr valign="top"> <td colspan="3" align="right"> <asp:label id="WelcomeMessage" runat="server" /> <a href="<%= Request.ApplicationPath %>">Portal 主页</a><span class="Accent"> |</span> <a href="<%= Request.ApplicationPath %>/Docs/Docs.htm"> Portal 文档</a> <%= LogoffLink %> </td> </tr> <tr> <td width="10" rowspan="2"> </td> <td height="40"> <asp:label id="siteName" runat="server" /> </td> <td align="center" rowspan="2"> </td> </tr> <tr> <td> <asp:datalist id="tabs" runat="server"> <ItemTemplate> <a href='<%= Request.ApplicationPath %>/DesktopDefault.aspx?tabindex=<%# Container.ItemIndex %>&tabid=<%# ((TabStripDetails) Container.DataItem).TabId %>'><%# ((TabStripDetails) Container.DataItem).TabName %></a> </ItemTemplate> <SelectedItemTemplate> <span class="SelectedTab"><%# ((TabStripDetails) Container.DataItem).TabName %></span> </SelectedItemTemplate> </asp:datalist> </td> </tr></table>
您可以使用 Visual Basic 和 C# 在 http://www.ibuyspy.com（英文）联机浏览并运行 IBuySpy Portal 的完整源文件，或者下载后再运行。
小结
Context 是 ASP.NET 中的又一个“精益求精”的功能。它扩展了 ASP 的已经很不错的上下文支持，以便将两个挂钩添加到 ASP.NET 的新运行时功能中。同时添加了 Context.Items，作为短期值的新状态机制。但对于开发人员，此功能的最大好处是使代码更紧凑，且易于维护，而且此上下文我们都能看懂。
Trackback: http://tb.blog.csdn.net/TrackBack.aspx?PostId=119531