HttpResponse.WriteSubstitution(HttpResponseSubstitutionCallback) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Позволяет выполнять вставку блоков замены ответа в ответ, что предоставляет возможность для динамического формирования указанных областей ответа для выходных кэшируемых ответов.
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.
