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.

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

См. также раздел