HttpResponse.WriteSubstitution(HttpResponseSubstitutionCallback) Метод

Определение

Позволяет выполнять вставку блоков замены ответа в ответ, что предоставляет возможность для динамического формирования указанных областей ответа для выходных кэшируемых ответов.Allows insertion of response substitution blocks into the response, which allows dynamic generation of specified response regions for output cached responses.

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

Метод, пользовательский элемент управления или объект для замены.The method, user control, or object to substitute.

Исключения

Целевой объект параметра callback имеет тип Control.The target of the callback parameter is of type Control.

Комментарии

Можно использовать метод WriteSubstitution для подстановки после кэширования на страницах, кэшированных на выходе.You can use the WriteSubstitution method for post-cache substitution in your output-cached pages. Передавая объект HttpContext в метод обратного вызова с предписанной сигнатурой HttpResponseSubstitutionCallback, можно заменить выходное кэшированное содержимое в любом заданном расположении в кэше страниц.By passing a HttpContext object to a callback method with a prescribed HttpResponseSubstitutionCallback signature, you can replace output cached content at any given location in the page cache. Чтобы начать замену, вызовите метод WriteSubstitution, передав ему метод обратного вызова, который должен быть потокобезопасным и может быть одним из следующих:To initiate the replacement, call the WriteSubstitution method, passing it the callback method, which must be thread safe and can be either of the following:

  • Статический метод на странице контейнера или в пользовательском элементе управления.A static method on the container page or user control.

  • Статический метод или экземпляр для другого произвольного объекта.A static or instance method on another arbitrary object.

При первом запросе к странице WriteSubstitution вызывает делегат HttpResponseSubstitutionCallback для получения выходных данных.On the first request to the page, the WriteSubstitution calls the HttpResponseSubstitutionCallback delegate to produce the output. Затем он добавляет к ответу буфер подстановки, который оставляет делегат для вызова в будущих запросах.Then, it adds a substitution buffer to the response, which retains the delegate to call on future requests. Наконец, она снижает возможность кэширования на стороне клиента с общедоступного до сервера, гарантируя, что будущие запросы к странице повторно вызывают делегат, не кэшированные на клиенте.Finally, it degrades client-side cacheability from public to server-only, ensuring future requests to the page re-invoke the delegate by not caching on the client.

Примечание

Подстановка после кэширования не поддерживается для кэшированного пользовательского элемента управления, где кэширование вывода применяется на уровне пользовательского элемента управления.Post-cache substitution is not supported for a cached user control where output caching is applied at the user control level. Это также называется кэшированием фрагментов.This is also known as fragment caching. Дополнительные сведения см. в разделе Кэширование частей страницы ASP.NET.For more information, see Caching Portions of an ASP.NET Page.

Применяется к

Дополнительно