fragmentcaching.aspx

书籍教程 >> .Net教程 >> asp.net编程精彩百例

<%@ Register TagPrefix="Acme" Namespace="Acme" Assembly="QSTools" %>
<%@ Register TagPrefix="Acme" TagName="SourceRef" Src="/quickstart/aspplus/util/SrcRef.ascx"%>

<!-- #include virtual="/quickstart/aspplus/include/header.inc" -->

<h4>页片段缓存</h4>

除了输出缓存整页外，ASP.NET 还为您提供了输出缓存页内容区域的简单方法，此方法被恰当地称作片段缓存。使用<a href="webpagelets.aspx">用户控件</a>勾划页面的区域，并使用上节介绍的 <b>@ OutputCache</b> 指令将它们标记为供缓存使用。此指令指定用户控件的输出内容在服务器上缓存的持续时间（以秒为单位），以及改变此持续时间所依据的可选条件。
<p>
例如，下列指令指示 ASP.NET 输出缓存用户控件 120 秒，并使用“CategoryID”和“SelectedID”查询字符串或窗体发布参数改变缓存。
<p>

<div class="code"><pre>
&lt;%@ OutputCache Duration="120" VaryByParam="CategoryID;SelectedID"%&gt;
</pre></div>

<p>
<b>VaryByParam</b> 属性功能十分强大，它允许用户控件作者指示 ASP.NET 在服务器上缓存/存储输出缓存区域的多个实例。例如，前一个用户控件的宿主页的下列 URL 缓存用户控件内容的单独实例。
<p>

<div class="indent">
  <u>http://localhost/mypage.aspx?categoryid=foo&selectedid=0</u><br>    <u>http://localhost/mypage.aspx?categoryid=foo&selectedid=1</u>
</div>


<p>
用户控件内的逻辑因此能够根据提供的参数动态生成不同的内容（单独缓存）。

<p>
除了支持 <b>VaryByParam</b> 属性外，片段缓存还支持 <b>VaryByControl</b> 属性。<b>VaryByParam</b> 属性基于使用 <b>POST</b> 或 <b>GET</b> 发送的名称/值对改变缓存结果，而 <b>VaryByControl</b> 属性则通过用户控件中的控件改变缓存片段。例如：
<div class="code"><pre>
&lt;%@ OutputCache Duration="120" VaryByParam="none" VaryByControl="Category" %&gt;
</pre></div>
<p>
注意：与输出缓存页相似，即使不使用 <b>VaryByParam</b>，也要求显式使用它。
<p>
如果用户控件包含名为“Category”的下拉选择框控件，用户控件的输出将基于在该控件中选择的值改变。

<p>
正如可以在页中递归嵌套用户控件（即在另一服务器控件中声明的用户控件）一样，也可以递归嵌套输出缓存用户控件。这提供了一个功能强大的撰写模型，此模型使缓存的区域能够由进一步子缓存的区域组成。
<p>

下面的示例代码说明如何使用声明性用户控件缓存页的两个菜单部分。
<p>
<Acme:TabControl runat="server">
<Tab Name="C#">
&lt;%@ Register TagPrefix="Acme" TagName="Menu" Src="Menu.ascx" %&gt;

&lt;html&gt;
  &lt;body&gt;
    &lt;table&gt;
      &lt;tr&gt;
        &lt;td&gt;
          &lt;Acme:Menu Category="LeftMenu" runat=server/&gt;
        &lt;/td&gt;
        &lt;td&gt;
          &lt;h1&gt;Hi, the time is now: &lt;%=DateTime.Now%&gt; &lt;/h1&gt;
        &lt;/td&gt;
        &lt;td&gt;
          &lt;Acme:Menu Category="RightMenu" runat=server/&gt;
        &lt;/td&gt;
      &lt;tr&gt;
    &lt;/table&gt;
  &lt;/body&gt;
&lt;/html&gt;
</Tab>
<Tab Name="VB">
&lt;%@ Register TagPrefix="Acme" TagName="Menu" Src="Menu.ascx" %&gt;

&lt;html&gt;
  &lt;body&gt;
    &lt;table&gt;
      &lt;tr&gt;
        &lt;td&gt;
          &lt;Acme:Menu Category="LeftMenu" runat=server/&gt;
        &lt;/td&gt;
        &lt;td&gt;
          &lt;h1&gt;Hi, the time is now: &lt;%=Now%&gt; &lt;/h1&gt;
        &lt;/td&gt;
        &lt;td&gt;
          &lt;Acme:Menu Category="RightMenu" runat=server/&gt;
        &lt;/td&gt;
      &lt;tr&gt;
    &lt;/table&gt;
  &lt;/body&gt;
&lt;/html&gt;
</Tab>
<Tab Name="JScript">
&lt;%@ Register TagPrefix="Acme" TagName="Menu" Src="Menu.ascx" %&gt;

&lt;html&gt;
  &lt;body&gt;
    &lt;table&gt;
      &lt;tr&gt;
        &lt;td&gt;
          &lt;Acme:Menu Category="LeftMenu" runat=server/&gt;
        &lt;/td&gt;
        &lt;td&gt;
          &lt;h1&gt;Hi, the time is now: &lt;%=DateTime.Now%&gt; &lt;/h1&gt;
        &lt;/td&gt;
        &lt;td&gt;
          &lt;Acme:Menu Category="RightMenu" runat=server/&gt;
        &lt;/td&gt;
      &lt;tr&gt;
    &lt;/table&gt;
  &lt;/body&gt;
&lt;/html&gt;
</Tab>
</Acme:TabControl>

<p>
下面的示例代码显示具有缓存支持的“Acme:Menu”用户控件的实现。
<p>

<Acme:TabControl runat="server">
<Tab Name="C#">
&lt;%@ OutputCache Duration="120" VaryByParam="none" %&gt;

&lt;script language="C#" runat=server&gt;

    public String Category;

    void Page_Load(Object sender, EventArgs e)  {

        AdoConnection conn = new AdoConnection("MyDSN");

        MyMenu.DataSource = conn.Execute("select * from menu where category=" + Category );
        MyMenu.DataBind();
    }

&lt;/script&gt;

&lt;asp:datagrid id="MyMenu" runat=server/&gt;
</Tab>
<Tab Name="VB">
&lt;%@ OutputCache Duration="120" VaryByParam="none" %&gt;

&lt;script language="VB" runat=server&gt;

    Public Category As String;

    Sub Page_Load(sender As Object, e As EventArgs)

        Dim conn As AdoConnection = New AdoConnection("MyDSN")

        MyMenu.DataSource = conn.Execute("select * from menu where category=" & Category)
        MyMenu.DataBind()
    End Sub

&lt;/script&gt;

&lt;asp:datagrid id="MyMenu" runat=server/&gt;
</Tab>
<Tab Name="JScript">
&lt;%@ OutputCache Duration="120" VaryByParam="none" %&gt;

&lt;script language="JScript" runat=server&gt;

    public var Category:String;

    function Page_Load(sender:Object, e:EventArgs) : void {

        var conn:AdoConnection = new AdoConnection("MyDSN");

        MyMenu.DataSource = conn.Execute("select * from menu where category=" + Category );
        MyMenu.DataBind();
    }

&lt;/script&gt;

&lt;asp:datagrid id="MyMenu" runat=server/&gt;
</Tab>
</Acme:TabControl>
<p>

注意：此示例将每个用户控件的响应输出缓存 120 秒。在缓存未命中（因为已超过 120 秒，或者因为服务器上的内存已变得不足）时重建每个菜单用户控件所需的全部逻辑完全封装在用户控件中。
<p>

下面的示例显示了简单的片段缓存。此示例缓存从 SQL Server 数据库检索数据的控件的输出，同时保持父页的动态属性。可以看到页是动态的，因为时间随着每次刷新而更新，而控件只是每隔 60 秒更新一次。
<p>

<Acme:LangSwitch runat="server">
  <CsTemplate>
<Acme:SourceRef
  RunSample="/quickstart/aspplus/samples/cache/CS/fragmentcache1.aspx"
  ViewSource="/quickstart/aspplus/samples/cache/fragmentcache1.src"
  Icon="/quickstart/aspplus/images/outputcache2.gif"
  Caption="C# FragmentCache1.aspx"
  runat="server" />
  </CsTemplate>
  <VbTemplate>
<Acme:SourceRef
  RunSample="/quickstart/aspplus/samples/cache/VB/fragmentcache1.aspx"
  ViewSource="/quickstart/aspplus/samples/cache/fragmentcache1.src"
  Icon="/quickstart/aspplus/images/outputcache2.gif"
  Caption="VB FragmentCache1.aspx"
  runat="server" />
  </VbTemplate>
  <JsTemplate>
<Acme:SourceRef
  RunSample="/quickstart/aspplus/samples/cache/JS/fragmentcache1.aspx"
  ViewSource="/quickstart/aspplus/samples/cache/fragmentcache1.src"
  Icon="/quickstart/aspplus/images/outputcache2.gif"
  Caption="JScript FragmentCache1.aspx"
  runat="server" />
  </JsTemplate>
</Acme:LangSwitch>

<p>

<h5>注意事项</h5>

<p>
<b>注意：</b>试图以编程方式从输出缓存控件的包含页对该输出缓存控件进行操作将导致错误。例如，试图在用户控件标记上使用声明性数据绑定表达式将生成分析错误，如下列代码所示。

<p>
<div class="code"><pre>
&lt;!-- The following tags generate parser errors. --&gt;
&lt;Acme:Menu Category='&lt;%# Container.DataItem("Category")'  runat="server"/&gt;
</pre></div>
<p>

其中的原因很简单。在用户控件的内容被输出缓存的情况中，仅在第一次请求时创建控件的实例；因此，控件一旦缓存将不再可用。相反，应该将创建用户控件内容所需的全部逻辑直接封装在控件本身中；这通常在用户控件的 <b>Page_Load</b> 事件或 <b>Page_PreRender</b> 事件中完成。

<p>

可以声明和使用其他声明性属性参数来自定义控件。例如，可以如下自定义前面的用户控件：

<p>
<div class="code"><pre>
&lt;Acme:Menu Category="LeftMenu" runat=server/&gt;
&lt;Acme:Menu Category="RightMenu" runat=server/&gt;
</pre></div>
<p>

这些声明导致在因缓存未命中而创建控件时，生成适当的代码并由页编译器来执行这些代码。这样，用户控件开发人员就可以像在非缓存用户控件情况中那样访问这些设置。

<h4>本节小结</h4>
<ol>
<li>除了输出缓存整页外，ASP.NET 还为您提供了输出缓存页内容区域的简单方法，此方法被恰当地称作片段缓存。
<li>使用用户控件描绘页区域，并使用上节介绍的 <b>@ OutputCache</b> 指令将它们标记为缓存。
<li>正如可以在页中递归嵌套用户控件（即在另一服务器控件中声明的用户控件）一样，也可以递归嵌套输出缓存用户控件。
<li>试图以编程方式从输出缓存控件的包含页操作它将导致错误。相反，应该将创建用户控件内容所需的全部逻辑直接封装在控件本身中；这通常在用户控件的 <b>Page_Load</b> 事件或 <b>Page_PreRender</b> 事件中完成。
<li>可以声明和使用其他声明性属性参数来自定义控件。
</ol>
<p>

<!-- #include virtual="/quickstart/aspplus/include/footer.inc" -->