以上@ OutputCache指令设置页面输出缓存的有效期是100秒,并且根据查询字符串参数location或者firstname来设置输出缓存。例如,假设客户端请求是“http://localhost/default.aspx?location=beijing”,那么该页面将被作为缓存处理。
使用页面输出缓存API 上文介绍了使用@ OutputCache指令实现对于输出缓存的各项设置。这种方法简单易行,深得开发人员青睐。另外,ASP.NET 2.0还从ASP.NET 1.x中继承和扩展了一种使用输出缓存API来编程设置页面输出缓存的方法。该方法的核心是调用System.Web.HttpCachePolicy。该类主要包含用于设置缓存特定的HTTP标头的方法和用于控制ASP.NET页面输出缓存的方法。与.NET Framework 1.x中的HttpCachePolicy类相比,.NET Framework 2.0中的HttpCachePolicy类得到了扩充和发展。主要是增加了一些重要方法,例如,SetOmitVarStar方法等。由于HttpCachePolicy类方法众多,下面简要说明一些常用方法。 SetExpires方法 用于设置缓存过期的绝对时间。它的参数是一个DataTime类的实例,表示过期的绝对时间。 SetLastModified方法 用于设置页面的Last-Modified HTTP标头。Last-Modified HTTP标头表示页面上次修改时间,缓存将依靠它来进行计时。如果违反了缓存限制层次结构,此方法将失败。该方法的参数是一个DataTime类的实例。 SetSlidingExpiration方法 该方法将缓存过期从绝对时间设置为可调时间。其参数是一个布尔值。当参数为true时,Cache-Control HTTP标头将随每个响应而更新。此过期模式与相对于当前时间将过期标头添加到所有输出集的IIS配置选项相同。当参数为false时,将保留该设置,且任何启用可调整过期的尝试都将静态失败。此方法不直接映射到HTTP标头。它由后续模块或辅助请求来设置源服务器缓存策略。 SetOmitVaryStar方法 ASP.NET 2.0新增的方法。用于指定在按参数进行区分时,响应是否应该包含vary:*标头。方法参数是一个布尔值,若要指示HttpCachePolicy不对其VaryByHeaders属性使用*值,则为true;否则为false。 SetCacheability方法 用于设置页面的Cache-Control HTTP标头。该标头用于控制在网络上缓存文档的方式。该方法有两种重载方式,所不同的是参数。一种重载方法的参数是HttpCacheability枚举值,包括NoCache、Private、Public、Server、ServerAndNoCache和ServerAndPrivate(有关这些枚举值的定义,可参考MSDN)。另一种方法的参数有两个,一个参数是HttpCacheability枚举值,另一个参数是字符串,表示添加到标头的缓存控制扩展。需要注意的是,仅当与Private或NoCache指令一起使用时,字段扩展名才有效。如果组合不兼容的指令和扩展,则此方法将引发无效参数异常。 下面举例说明页面缓存API的HttpCachePolicy类的使用方法。 HttpCachePolicy类示例源代码 Response.Cache.SetExpires(DateTime.Now.AddSeconds(60)); Response.Cache.SetExpires(DateTime.Parse("6:00:00PM")); Response类的Cache属性用于获取页面缓存策略。该属性的数据类型是HttpCachePolicy。可通过调用Response.Cache来获取HttpCachePolicy实例,进而实现对于当前页面输出缓存的设置。如上代码所示,第一行代码表示输出缓存时间是60秒,并且页面不随任何GET或POST参数改变,等同于“<%@ OutputCache Duration="60" VaryByParam="none" %>”。第二行代码设置缓存过期的绝对时间是当日下午6时整。
页面输出缓存应用 以上两小节分别介绍了使用@ OutputCache指令和API设置页面输出缓存功能的内容。实际上,两种方法各有优点,使用@ OutputCache指令方法比较简洁,但灵活性较差。使用API方法,能够在运行时动态地修改缓存配置,处理更多的复杂需求。本节将利用这些知识,实现一个简单的页面输出缓存应用的示例,其中既涉及@ OutputCache指令应用,又涉及页面输出缓存API。示例效果如图12-1和图12-2所示。 图1 停止缓存的效果图 图12-2 执行缓存的效果图 如图1所示,应用程序初始显示的是停止执行缓存的时间。当用户刷新页面(URL地址是http://localhost:5159/Code%2012-1/Default.aspx,其中5159是服务器临时端口号)时,时间值将随时变化,以便显示当前的最新时间。如图12-2所示,单击“缓存时间”超链接后,页面重定向到http://localhost:5159/Code%2012-1/Default.aspx?location=beijing。这时,页面显示的时间被缓存,数据过期时间为5秒。如果不断地刷新该页,那么每隔5秒钟时间值才变化一次。 本节示例存在两个关键点。一是在运行时实现停止缓存,二是配置@ OutputCache指令。这两点都已经在应用程序Default.aspx文件中予以实现,下面列举了该文件源代码。 Default.aspx文件源代码 <%@ Page Language="C#" AutoEventWireup="true" CodeFile="Default.aspx.cs" Inherits="_Default" %> <%@ OutputCache Duration="5" VaryByParam="location" %> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"> <script language="C# " runat="server"> void Page_Load(object sender, EventArgs e) { //设置仅将缓存数据存储在服务器上 Response.Cache.SetCacheability(HttpCacheability.Server); string temp_location = Request.QueryString["location"]; //如果location为空,则不缓存,否则根据@ OutputCache指令声明执行缓存 if (temp_location == null) { //停止当前响应的所有服务器缓存 Response.Cache.SetNoServerCaching(); Label1.Text = "停止缓存的时间:" + DateTime.Now.ToString(); } else { Label1.Text = "设置了缓存的时间:" + DateTime.Now.ToString(); } } </script> <head id="Head1" runat="server"> <title>示例12-1</title> <link id="InstanceStyle" href="StyleSheet.css" type="text/css" rel="stylesheet" /> </head> <body> <form id="form1" runat="server"> <div> <fieldset style="width: 240px"> <legend class="mainTitle">设置页面输出缓存</legend> <br /> <center><asp:Label ID="Label1" runat="server" CssClass="commonText"></asp:Label></center> <br /> <a href="Default.aspx?location=beijing" class="littleMainTitle" >缓存时间</a><br /> </fieldset> </div> </form> </body> </html> 如上粗体代码所示,代码头部的@ OutputCache指令设置了Duration和VaryByParam属性,其指示数据过期时间为5秒。同时,缓存根据参数location发生变化。另外,代码还实现了Page_Load事件处理程序。在该程序中,首先,使用SetCacheability方法设置数据缓存必须存储在服务器上,然后,获取QueryString的location参数值,最后,根据location参数值进行判断。如果location参数值为空,则调用SetNoServerCaching方法停止当前响应的所有服务器缓存,并显示当前时间值。虽然@ OutputCache指令配置了页面输出缓存,但是,不会执行页面输出缓存功能。如果location参数值不为空,则直接显示当前时间值。在这种情况下,将执行@ OutputCache指令的配置内容。