HttpResponse.WriteSubstitution(HttpResponseSubstitutionCallback) 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
允许将响应替换块插入响应，从而允许为缓存的输出响应动态生成指定的响应区域。
public:
void WriteSubstitution(System::Web::HttpResponseSubstitutionCallback ^ callback);public void WriteSubstitution (System.Web.HttpResponseSubstitutionCallback callback);member this.WriteSubstitution : System.Web.HttpResponseSubstitutionCallback -> unitPublic Sub WriteSubstitution (callback As HttpResponseSubstitutionCallback)参数
- callback
- HttpResponseSubstitutionCallback
要替换的方法、用户控件或对象。
例外
callback 参数的目标的为 Control 类型。
注解
可以使用 WriteSubstitution 方法在输出缓存页中替换后缓存。 通过将 对象传递给 HttpContext 具有规定签名的 HttpResponseSubstitutionCallback 回调方法，可以替换页面缓存中任意给定位置的输出缓存内容。 若要启动替换，请调用 WriteSubstitution 方法，并向其传递回调方法，该方法必须是线程安全的，可以是以下任一项：
- 容器页或用户控件上的静态方法。
- 另一个任意对象上的静态或实例方法。
在对页面的第一个请求中 WriteSubstitution ， 调用 HttpResponseSubstitutionCallback 委托以生成输出。 然后，它将一个替换缓冲区添加到响应，以保留委托，以在未来的请求中调用。 最后，它会将客户端的可缓存性从公共降级为仅限服务器，确保将来对页面的请求不会在客户端上缓存来重新调用委托。
注意
缓存的用户控件不支持缓存后替换，该控件在用户控件级别应用输出缓存。 这也称为片段缓存。 有关详细信息，请参阅 缓存 ASP.NET 页的部分。
