缓存 ASP.NET 页的某些部分

项目
10/22/2014

更新：2007 年 11 月

有时缓存整个页是不现实的，因为页的某些部分可能在每次请求时都需要更改。在这些情况下，只能缓存页的一部分。执行此操作有两个选项：控件缓存和缓存后替换。

在控件缓存（也称为片段缓存）中，可以通过创建用户控件来包含缓存的内容，然后将用户控件标记为可缓存来缓存部分页输出。该选项允许缓存页中的特定内容，而在每次都重新创建整个页。例如，如果创建的页显示大量动态内容（如股票信息），但也有某些部分是静态的（如每周摘要），则可以在用户控件中创建这些静态部分并将用户控件配置为缓存。

缓存后替换与控件缓存正好相反。它对页进行缓存，但是页中的某些片段是动态的，因此不会缓存这些片段。例如，如果创建的页在设定的时间段内完全是静态的（例如新闻报道页），可以设置为缓存整个页。如果为缓存的页添加旋转广告横幅，则在页请求之间，广告横幅不会变化。然而，使用缓存后替换，可以对页进行缓存，但可以将特定部分标记为不可缓存。在本例中，将广告横幅标记为不可缓存。它们将在每次页请求时动态创建，并添加到缓存的页输出中。有关缓存后替换的更多信息，请参阅动态更新缓存页的部分。

控件缓存

通过创建用户控件来缓存内容，可以将页上需要花费宝贵的处理器时间来创建的某些部分（例如数据库查询）与页的其他部分分离开。只需占用很少服务器资源的部分可以在每次请求时动态生成。

在标识了要缓存的页的部分，并创建了用以包含这些部分中的每个部分的用户控件后，您必须确定这些用户控件的缓存策略。您可以使用 @ OutputCache 指令，或者在代码中使用 PartialCachingAttribute 类，以声明的方式为用户控件设置这些策略。

例如，如果在用户控件文件（.ascx 文件）的顶部包括下面的指令，则该控件的一个版本将在输出缓存中存储 120 秒。

<%@ OutputCache Duration="120" VaryByParam="None" %>

若要在代码中设置缓存参数，可以在用户控件的类声明中使用一个属性。例如，如果在类声明的元数据中包括下面的属性，则该内容的一个版本将在输出缓存中存储 120 秒：

[PartialCaching(120)]
public partial class CachedControl : System.Web.UI.UserControl
{
    // Class Code
}

<PartialCaching(120)> _
Partial Class CachedControl
    Inherits System.Web.UI.UserControl
    ' Class Code
End Class

有关可在页输出中设置的属性的更多信息，请参阅 @ OutputCache 主题。有关如何开发用户控件的更多信息，请参见 ASP.NET Web 服务器控件概述。

说明：
由于可在页上嵌套用户控件，您还可以嵌套已放置到输出缓存中的用户控件。可以为页和嵌套的用户控件指定不同的缓存设置。

以编程方式引用缓存的用户控件

在以声明的方式创建可缓存的用户控件时，可以包括一个 ID 属性，以便以编程方式引用该用户控件实例。但是，在代码中引用用户控件之前，必须验证在输出缓存中是否存在该用户控件。缓存的用户控件只在首次请求时动态生成；在指定的时间到期之前，从输出缓存满足所有的后续请求。确定用户控件已实例化后，可以从包含页以编程方式操作该用户控件。例如，如果通过声明方式将 SampleUserControl 的 ID 分配给用户控件，则可以使用下面的代码检查它是否存在。

protected void Page_Load(object sender, EventArgs e)
{
    if (SampleUserControl != null)
       // Place code manipulating SampleUserControl here.
}

Protected Sub Page_Load(ByVal sender As Object, _
        ByVal e As System.EventArgs) Handles Me.Load
    If SampleUserControl <> Nothing Then
       ' Place code manipulating SampleUserControl here.
    End If
End Sub

以不同的持续时间缓存页和用户控件

可以为页和页上的用户控件设置不同的输出缓存持续时间值。如果页的输出缓存持续时间长于用户控件的输出缓存持续时间，则页的输出缓存持续时间优先。例如，如果页的输出缓存设置为 100 秒，而用户控件的输出缓存设置为 50 秒，则包括用户控件在内的整个页将在输出缓存中存储 100 秒，而与用户控件较短的时间设置无关。

下面的代码示例演示了当页的缓存持续时间长于用户控件的缓存持续时间时的效果。该页配置为缓存 100 秒。

<%@ Page language="C#" %>
<%@ Register tagprefix="SampleControl" tagname="Time" src="uc01.ascx" %>
<%@ OutputCache duration="100" varybyparam="none" %>

<SampleControl:Time runat="server" /><br /> <br /> <br />

This page was most recently generated at:<p>

<% DateTime t = DateTime.Now.ToString(); 
    Response.Write(t); %>

<%@ Page language="VB" %>
<%@ Register tagprefix="SampleControl" tagname="Time" src="uc01.ascx" %>
<%@ OutputCache duration="100" varybyparam="none" %>

<SampleControl:Time runat="server" /><br /> <br /> <br />

This page was most recently generated at:<p>
<% Dim t As DateTime = DateTime.Now.ToString()
Response.Write(t) %>

下面的代码示例演示了包括在页中的用户控件。控件的缓存持续时间设置为 50 秒。

<% @Control language="C#" %>
<% @OutputCache duration="50" varybyparam="none" %>

This user control was most recently generated at:<p>
<% DateTime t = DateTime.Now.ToString(); 
    Response.Write(t); %>

<% @Control language="VB" %>
<% @OutputCache duration="50" varybyparam="none" %>

This user control was most recently generated at:<p>
<% Dim t As DateTime = DateTime.Now.ToString()
Response.Write(t) %>

不过，如果页的输出缓存持续时间比用户控件的输出缓存持续时间短，则即使已为某个请求重新生成该页的其余部分，也将一直缓存用户控件直到其持续时间到期为止。例如，如果页的输出缓存设置为 50 秒，而用户控件的输出缓存设置为 100 秒，则页的其余部分每到期两次，用户控件才到期一次。

下面的代码演示了一个页的标记，该页中包含的用户控件的缓存持续时间长于该页的缓存持续时间。该页配置为缓存 50 秒。

<%@ Page language="C#" %>
<%@ Register tagprefix="SampleControl" tagname="Time" src="uc2.ascx" %>
<%@ OutputCache duration="50" varybyparam="none" %>

<SampleControl:Time runat="server" /><br /> <br /> <br />

This page was most recently generated at:<p>
 <% DateTime t = DateTime.Now.ToString(); 
    Response.Write(t); %>

<%@ Page language="VB" %>
<%@ Register tagprefix="SampleControl" tagname="Time" src="Uc2.ascx" %>
<%@ OutputCache duration="50" varybyparam="none" %>

<SampleControl:Time runat="server" /><br /> <br /> <br />

This page was most recently generated at:<p>
 <% Dim t As DateTime = DateTime.Now.ToString()
Response.Write(t) %>

下面的代码演示了包括在页中的用户控件。控件的缓存持续时间设置为 100 秒。

<% @Control language="C#" %>
<% @OutputCache duration="100" varybyparam="none" %>

This user control was most recently generated at:<p>

<% DateTime t = DateTime.Now.ToString(); 
    Response.Write(t); %>

<% @Control language="VB" %>
<% @OutputCache duration="100" varybyparam="none" %>

This user control was most recently generated at:<p>
<% Dim t As DateTime = DateTime.Now.ToString()
Response.Write(t) %>

请参见

概念

其他资源

ASP.NET 缓存中的新增功能