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".