HttpResponse.WriteSubstitution(HttpResponseSubstitutionCallback) 方法

定义

允许将响应替换块插入响应,从而允许为缓存的输出响应动态生成指定的响应区域。

public:
 void WriteSubstitution(System::Web::HttpResponseSubstitutionCallback ^ callback);
public void WriteSubstitution (System.Web.HttpResponseSubstitutionCallback callback);
member this.WriteSubstitution : System.Web.HttpResponseSubstitutionCallback -> unit
Public Sub WriteSubstitution (callback As HttpResponseSubstitutionCallback)

参数

callback
HttpResponseSubstitutionCallback

要替换的方法、用户控件或对象。

例外

callback 参数的目标的为 Control 类型。

注解

可以使用 WriteSubstitution 方法在输出缓存页中替换后缓存。 通过将 对象传递给 HttpContext 具有规定签名的 HttpResponseSubstitutionCallback 回调方法,可以替换页面缓存中任意给定位置的输出缓存内容。 若要启动替换,请调用 WriteSubstitution 方法,并向其传递回调方法,该方法必须是线程安全的,可以是以下任一项:

  • 容器页或用户控件上的静态方法。
  • 另一个任意对象上的静态或实例方法。

在对页面的第一个请求中 WriteSubstitution , 调用 HttpResponseSubstitutionCallback 委托以生成输出。 然后,它将一个替换缓冲区添加到响应,以保留委托,以在未来的请求中调用。 最后,它会将客户端的可缓存性从公共降级为仅限服务器,确保将来对页面的请求不会在客户端上缓存来重新调用委托。

注意

缓存的用户控件不支持缓存后替换,该控件在用户控件级别应用输出缓存。 这也称为片段缓存。 有关详细信息,请参阅 缓存 ASP.NET 页的部分

适用于

另请参阅