通过

Substitution Web 服务器控件概述

更新：2007 年 11 月

您可以使用 Substitution 控件，在网页上创建可动态更新并可随后集成到缓存页中的区域。

本主题包括：

  • 方案

  • 背景

  • 代码示例

  • 类参考

方案

使用 Substitution 控件可以在要缓存输出的网页上指定要显示动态内容的部分。对于多数内容都要进行缓存的页，Substitution 控件提供了进行部分页缓存的简化的解决方案。您可以缓存整个页的输出，然后使用 Substitution 控件来指定页中不进行缓存的部分。缓存区域仅执行一次，且将一直从缓存读取，直至该缓存条目到期或被清除。动态区域则在每次请求页时都会执行。此缓存模型简化了其内容主要是静态内容的网页的代码，因为您不必在 Web 用户控件中对这些静态内容进行封装，以将它们放入缓存。例如，对于包含静态内容（如新闻故事）和显示广告的 AdRotator 控件的网页，此缓存模型就非常有用。新闻故事不会经常更改，这意味着可以将它们放入缓存。您可能会希望在用户每次请求该网页时显示一条新广告。AdRotator 控件直接支持缓存后替换，无论是否缓存了网页，它都会在网页每次回发时呈现一个新广告。

返回页首

背景

缓存 ASP.NET 网页时，默认情况下，会缓存该网页的全部输出。在第一次请求时，该页将运行并缓存其输出。对于后续的请求，将通过缓存来完成，该页上的代码不会运行。

在某些情况下，您可能不但希望缓存 ASP.NET 网页，还希望在每次请求该网页时更新该网页上的选定部分。例如，您可能要缓存某页的很大一部分，但需要动态更新该页上的与时间高度相关的信息。

可以使用 Substitution 控件将动态内容插入到缓存页中。Substitution 控件不会呈现任何标记。因此，您需要将该控件绑定到网页或父级用户控件中的方法。您需要创建可返回要插入到网页中的信息的静态方法。由 Substitution 控件调用的方法必须符合下面的标准：

  • 必须为静态方法（在 Visual Basic 共享）。

  • 必须接受类型为 HttpContext 的参数。

  • 必须返回类型为 String 的值。

Substitution 控件无法访问网页上的其他控件，也就是说，您无法检查或更改其他控件的值。但代码却可使用传递给它的参数来访问当前网页的上下文。

在页运行时，Substitution 控件会调用该方法，然后用从该方法的返回值替换页上的 Substitution 控件。

返回页首

代码示例

下面的示例演示如何使用 Substitution 控件在缓存页上创建可动态更新的内容。页的 Load 事件中的代码用当前时间来更新 Label 控件。因为页的缓存持续时间已设置为 60 秒，所以 Label 控件的文本不会更改，即使在 60 秒的时间内多次请求了该页。页上的 Substitution 控件调用静态方法 GetTime，该方法将以字符串的形式返回当前时间。每次刷新网页时，都会更新 Substitution 控件表示的值。

<%@ 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>

<%@ 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>

返回页首

类参考

下表列出了与 Substitution 控件相关的类。

成员

说明

Substitution

控件的主类。

返回页首

请参见

概念

动态更新缓存页的部分