Share via

HttpResponse.WriteSubstitution(HttpResponseSubstitutionCallback) 方法

  • 参考

定义

命名空间:
System.Web
程序集:
System.Web.dll

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

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

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

例外

ArgumentException

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

注解

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

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

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

注意

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

适用于

另请参阅