Элемент outputCache для элемента caching (схема параметров ASP.NET)
Обновлен: Ноябрь 2007
Задает параметры кэша вывода на уровне приложения.
Элемент configuration (схема общих параметров)
Элемент system.web (схема параметров ASP.NET)
Элемент caching (схема параметров ASP.NET)
Элемент outputCache для элемента caching (схема параметров ASP.NET)
<outputCache enableOutputCache="true|false" enableFragmentCache="true|false" sendCacheControlHeader="true|false" omitVaryStar="true|false"> </outputCache>
Атрибуты и элементы
В следующих разделах описаны атрибуты, дочерние элементы и родительские элементы.
Атрибуты
Атрибут |
Описание |
|---|---|
enableOutputCache |
Необязательный атрибут Boolean. Включает/отключает кэширование выходных данных страницы. Если атрибут отключен, кэширование страниц не выполняется, несмотря на программные или декларативные параметры. Значение по умолчанию — true. |
enableFragmentCache |
Необязательный атрибут Boolean. Включает/отключает кэширование фрагмента приложения. Если атрибут отключен, кэширование страниц не выполняется, несмотря на используемую директиву @ OutputCache или профиль кэша. Включает заголовок cache-control, указывающий, что вышестоящие прокси-серверы, а также клиенты обозревателей не должны предпринимать попытку кэширования выходных данных страниц. Значение по умолчанию — false. |
sendCacheControlHeader |
Необязательный атрибут Boolean. Получает или задает значение, указывающее, отправлен ли заголовок cache-control:private с помощью модуля выходного кэша по умолчанию. Значение по умолчанию — false. |
omitVaryStar |
Необязательный атрибут Boolean. Включает/отключает отправку ответного заголовка HTTP "Vary: *". Заголовок "Vary: *" отправляется для кэшированных страниц; значение атрибута по умолчанию — "false". Значение по умолчанию — false. |
Дочерние элементы
Отсутствует.
Родительские элементы
Элемент |
Описание |
|---|---|
configuration |
Обязательный корневой элемент любого файла конфигурации, используемого средой CLR и приложениями .NET Framework. |
system.web |
Задает корневой элемент для параметров конфигурации ASP.NET в конфигурационном файле. Содержит конфигурационные элементы, которые настраивают веб-приложения ASP.NET, и управляют поведением этих приложений. |
caching |
Настраивает параметры кэширования для веб-приложения. |
Заметки
Настройки по умолчанию
Следующий элемент outputCache по умолчанию не настроен явно в файле конфигурации или в файле Web.config, но является конфигурацией по умолчанию, возвращаемой приложением в .NET Framework версии 2.0.
<outputCache enableOutputCache = "true"
enableFragmentCache = "true"
sendCacheControlHeader = "true"
omitVaryStar = "false">
</outputCache>
Пример
В следующем примере показано отключение выходного кэширования для приложения ASP.NET.
<outputCache enableOutputCache="false" />
Сведения об элементе
Обработчик раздела конфигурации |
|
Элемент конфигурации |
|
Настраиваемые расположения |
Machine.config Файл Web.config корневого уровня Файл Web.config уровня приложения |
Требования |
IIS версии 5.0, IIS версии 5.1 и IIS версии 6.0 ..NET Framework версии 2.0 Visual Studio 2005 |
См. также
Задачи
Практическое руководство. Настройка отдельных каталогов с помощью параметров расположения
Пошаговое руководство. Отключение параметров конфигурации ASP.NET
Основные понятия
Общие сведения о кэшировании в ASP.NET
Иерархия и наследование файла конфигурации ASP.NET
Настройка обеспечения безопасности ASP.NET
Ссылки
Элемент system.web (схема параметров ASP.NET)
Элемент configuration (схема общих параметров)
Элемент cache для элемента caching (схема параметров ASP.NET)
Другие ресурсы
Общие параметры конфигурации (ASP.NET)
Параметры конфигурации ASP.NET