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 页的Caching部分。

适用于

另请参阅