Substitution Web 服务器控件概述
2007-08-08 11:00
183 查看
Substitution 控件用在配置为需要进行缓存的 ASP.NET 网页上。Substitution 控件允许您在页上创建一些区域,这些区域可以用动态方式进行更新,然后集成到缓存页。
在某些情况下,可能要缓存 ASP.NET 页,但需根据每个请求更新页上选定的部分。例如,您可能要缓存某页的很大一部分,但需要动态更新该页上的与时间高度相关的信息。
可以使用 Substitution 控件将动态内容插入到缓存页中。Substitution 控件不会呈现任何标记。您需要将该控件绑定到页上或父用户控件上的方法中。您要自行创建静态方法,以返回要插入到页中的任何信息。由 Substitution 控件调用的方法必须符合下面的标准:
此方法被定义为静态方法(在 Visual Basic 中为共享方法)。
此方法接受 HttpContext 类型的参数。
此方法返回 String 类型的值。
注意,Substitution 控件无法访问页上的其他控件,也就是说,您无法检查或更改其他控件的值。但是,代码确实可以使用传递给它的参数来访问当前页上下文。
在页运行时,Substitution 控件会调用该方法,然后用从该方法的返回值替换页上的 Substitution 控件。
下面的代码示例演示如何使用 Substitution 控件在缓存页上创建动态更新的内容。页的 Load 事件中的代码用当前时间来更新 Label 控件。因为页的缓存持续时间已设置为 60 秒,所以 Label 控件的文本不会更改,即使在 60 秒的时间内多次请求了该页。页上的 Substitution 控件调用静态方法 GetTime,该方法将以字符串的形式返回当前时间。每次刷新页时,Substitution 控件表示的值都会更新。
Visual Basic
复制代码
C#
复制代码
动态更新缓存页的部分
缓存某个 ASP.NET 页时,默认情况下会缓存该页的全部输出。在第一次请求时,该页将运行并缓存其输出。对于后续的请求,将通过缓存来完成,该页上的代码不会运行。在某些情况下,可能要缓存 ASP.NET 页,但需根据每个请求更新页上选定的部分。例如,您可能要缓存某页的很大一部分,但需要动态更新该页上的与时间高度相关的信息。
可以使用 Substitution 控件将动态内容插入到缓存页中。Substitution 控件不会呈现任何标记。您需要将该控件绑定到页上或父用户控件上的方法中。您要自行创建静态方法,以返回要插入到页中的任何信息。由 Substitution 控件调用的方法必须符合下面的标准:
此方法被定义为静态方法(在 Visual Basic 中为共享方法)。
此方法接受 HttpContext 类型的参数。
此方法返回 String 类型的值。
注意,Substitution 控件无法访问页上的其他控件,也就是说,您无法检查或更改其他控件的值。但是,代码确实可以使用传递给它的参数来访问当前页上下文。
在页运行时,Substitution 控件会调用该方法,然后用从该方法的返回值替换页上的 Substitution 控件。
下面的代码示例演示如何使用 Substitution 控件在缓存页上创建动态更新的内容。页的 Load 事件中的代码用当前时间来更新 Label 控件。因为页的缓存持续时间已设置为 60 秒,所以 Label 控件的文本不会更改,即使在 60 秒的时间内多次请求了该页。页上的 Substitution 控件调用静态方法 GetTime,该方法将以字符串的形式返回当前时间。每次刷新页时,Substitution 控件表示的值都会更新。
Visual Basic
复制代码
<%@ Page Language="VB" %> <%@ OutputCache Duration=60 VaryByParam="None" %> <script runat="server"> Sub Page_Load() Label1.Text = DateTime.Now.ToString() End Sub Public Shared Function GetTime(ByVal context As HttpContext) _ As String Return DateTime.Now.ToString() End Function </script> <html> <head runat="server"></head> <body> <form id="form1" runat="server"> <div> <p> <asp:Label runat="server" ID="Label1" /> </p> <p> <asp:Substitution runat="server" ID="Substitution1" MethodName="GetTime" /> </p> <p> <asp:Button runat="server" ID="Button1" Text="Submit"/> </p> </div> </form> </body> </html>
C#
复制代码
<%@ Page Language="C#" %> <%@ OutputCache Duration=60 VaryByParam="None" %> <script runat="server"> void Page_Load() { Label1.Text = DateTime.Now.ToString(); } public static String GetTime(HttpContext context) { return DateTime.Now.ToString(); } </script> <html> <head runat="server"></head> <body> <form id="form1" runat="server"> <div> <p> <asp:Label runat="server" ID="Label1" /> </p> <p> <asp:Substitution runat="server" ID="Substitution1" MethodName="GetTime" /> </p> <p> <asp:Button runat="server" ID="Button1" Text="Submit"/> </p> </div> </form> </body> </html>
相关文章推荐
- ASP.NET - HiddenField Web 服务器控件概述
- ASP.NET - ImageMap Web 服务器控件概述(一)
- ASP.NET - Literal Web 服务器控件概述
- ASP.NET - MultiView 和 View Web 服务器控件概述(一)
- ASP.NET - TextBox Web 服务器控件概述
- ASP.NET - AdRotator Web 服务器控件概述
- ASP.NET - Button Web 服务器控件概述
- ASP.NET - CheckBox 和 CheckBoxList Web 服务器控件概述(上)
- ASP.NET 数据绑定 Web 服务器控件概述
- (转)Panel Web 服务器控件概述
- ASP.NET - DeclarativeCatalogPart Web 服务器控件概述
- 庖丁解牛ASP.NET3.5控件和组件开发技术-(1)服务器控件概述
- ASP.NET - ImageMap Web 服务器控件概述(二)
- ASP.NET - 本地化 Web 服务器控件概述
- ASP.NET - MultiView 和 View Web 服务器控件概述(二)
- ASP.NET - Panel Web 服务器控件概述
- ASP.NET - SiteMapDataSource Web 服务器控件概述
- ASP.NET - SiteMapPath Web 服务器控件概述
- ASP.NET - Calendar Web 服务器控件概述(中)
- ASP.NET - CheckBox 和 CheckBoxList Web 服务器控件概述(下)