例如，下列指令指示 ASP.NET 输出缓存用户控件 120 秒，并使用“CategoryID”和“SelectedID”查询字符串或窗体发布参数改变缓存。
<%@ OutputCache Duration="120" VaryByParam="CategoryID;SelectedID"%>
VaryByParam 属性功能十分强大，它允许用户控件作者指示 ASP.NET 在服务器上缓存/存储输出缓存区域的多个实例。例如，前一个用户控件的宿主页的下列 URL 缓存用户控件内容的单独实例。
http://localhost/mypage.aspx?categoryid=foo&selectedid=1
用户控件内的逻辑因此能够根据提供的参数动态生成不同的内容（单独缓存）。
除了支持 VaryByParam 属性外，片段缓存还支持 VaryByControl 属性。VaryByParam 属性基于使用 POST 或 GET 发送的名称/值对改变缓存结果，而 VaryByControl 属性则通过用户控件中的控件改变缓存片段。例如：
<%@ OutputCache Duration="120" VaryByParam="none" VaryByControl="Category" %>
注意：与输出缓存页相似，即使不使用 VaryByParam，也要求显式使用它。
如果用户控件包含名为“Category”的下拉选择框控件，用户控件的输出将基于在该控件中选择的值改变。
正如可以在页中递归嵌套用户控件（即在另一服务器控件中声明的用户控件）一样，也可以递归嵌套输出缓存用户控件。这提供了一个功能强大的撰写模型，此模型使缓存的区域能够由进一步子缓存的区域组成。
下面的示例代码说明如何使用声明性用户控件缓存页的两个菜单部分。
<script language="JavaScript"> function doClick(index, numTabs, id) { document.all("tab" + id, index).className = "tab"; for (var i=1; i < numTabs; i++) { document.all("tab" + id, (index + i) % numTabs).className = "backtab"; } document.all("code" + id, index).style.display = ""; for (var j=1; j < numTabs; j++) { document.all("code" + id, (index + j) % numTabs).style.display = "none"; } } </script>
<%@ Register TagPrefix="Acme" TagName="Menu" Src="Menu.ascx" %> <html> <body> <table> <tr> <td> <Acme:Menu Category="LeftMenu" runat=server/> </td> <td> <h1>Hi, the time is now: <%=DateTime.Now%> </h1> </td> <td> <Acme:Menu Category="RightMenu" runat=server/> </td> <tr> </table> </body> </html> <%@ Register TagPrefix="Acme" TagName="Menu" Src="Menu.ascx" %> <html> <body> <table> <tr> <td> <Acme:Menu Category="LeftMenu" runat=server/> </td> <td> <h1>Hi, the time is now: <%=Now%> </h1> </td> <td> <Acme:Menu Category="RightMenu" runat=server/> </td> <tr> </table> </body> </html> <%@ Register TagPrefix="Acme" TagName="Menu" Src="Menu.ascx" %> <html> <body> <table> <tr> <td> <Acme:Menu Category="LeftMenu" runat=server/> </td> <td> <h1>Hi, the time is now: <%=DateTime.Now%> </h1> </td> <td> <Acme:Menu Category="RightMenu" runat=server/> </td> <tr> </table> </body> </html> | |||
| C# | VB | JScript | |
下面的示例代码显示具有缓存支持的"Acme:Menu"用户控件的实现。
<%@ OutputCache Duration="120" VaryByParam="none" %> <script language="C#" runat=server> 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(); } </script> <asp:datagrid id="MyMenu" runat=server/> <%@ OutputCache Duration="120" VaryByParam="none" %> <script language="VB" runat=server> 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 </script> <asp:datagrid id="MyMenu" runat=server/> <%@ OutputCache Duration="120" VaryByParam="none" %> <script language="JScript" runat=server> 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(); } </script> <asp:datagrid id="MyMenu" runat=server/> | |||
| C# | VB | JScript | |
注意：此示例将每个用户控件的响应输出缓存 120 秒。在缓存未命中（因为已超过 120 秒，或者因为服务器上的内存已变得不足）时重建每个菜单用户控件所需的全部逻辑完全封装在用户控件中。
下面的示例显示了简单的片段缓存。此示例缓存从 SQL Server 数据库检索数据的控件的输出，同时保持父页的动态属性。可以看到页是动态的，因为时间随着每次刷新而更新，而控件只是每隔 60 秒更新一次。
[ 运行示例] | [ 查看源代码] |
注意事项
注意：试图以编程方式从输出缓存控件的包含页对该输出缓存控件进行操作将导致错误。例如，试图在用户控件标记上使用声明性数据绑定表达式将生成分析错误，如下列代码所示。
<!-- The following tags generate parser errors. --> <Acme:Menu Category='<%# Container.DataItem("Category")' runat="server"/>
其中的原因很简单。在用户控件的内容被输出缓存的情况中，仅在第一次请求时创建控件的实例；因此，控件一旦缓存将不再可用。相反，应该将创建用户控件内容所需的全部逻辑直接封装在控件本身中；这通常在用户控件的 Page_Load 事件或 Page_PreRender 事件中完成。
可以声明和使用其他声明性属性参数来自定义控件。例如，可以如下自定义前面的用户控件：
<Acme:Menu Category="LeftMenu" runat=server/> <Acme:Menu Category="RightMenu" runat=server/>
这些声明导致在因缓存未命中而创建控件时，生成适当的代码并由页编译器来执行这些代码。这样，用户控件开发人员就可以像在非缓存用户控件情况中那样访问这些设置。
2756
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
