Элемент outputCacheSettings для элемента caching (схема параметров ASP.NET)

Определяет параметры профиля кэша вывода, которые можно использовать на страницах приложения ASP.NET.

<outputCacheSettings>
    <outputCacheProfiles>...</outputCacheProfiles>
</outputCacheSettings>

Атрибуты и элементы

В следующих разделах описаны атрибуты, дочерние и родительские элементы.

Атрибуты

Отсутствует.

Дочерние элементы

Элемент	Описание
outputCacheProfiles	Содержит группы параметров кэша, которые можно использовать на страницах для определения директивы OutputCache.

Родительские элементы

Элемент	Описание
configuration	Обязательный корневой элемент любого файла конфигурации, используемого средой CLR и приложениями .NET Framework.
system.web	Указывает корневой элемент для параметров конфигурации ASP.NET в файле конфигурации. Содержит конфигурационные элементы, которые настраивают веб-приложения ASP.NET, и управляют поведением этих приложений.
caching	Настраивает параметры кэширования для веб-приложения.

Заметки

Настройки по умолчанию

Следующий используемый по умолчанию элемент outputCacheSettings не задан явно в файле конфигурации компьютера или в корневом файле Web.config, но является конфигурацией по умолчанию, возвращаемой приложением в .NET Framework версии 2.0.

<outputCacheSettings>
  <outputCacheProfiles>
    <add name = "" 
      enabled = "true" 
      duration = "-1" 
      location = "" 
      sqlDependency = "" 
      varyByCustom = "" 
      varyByControl = "" 
      varyByHeader = "" 
      varyByParam = "" 
      noStore = "false"/>
  </outputCacheProfiles>
</outputCacheSettings>
<outputCacheSettings>
  <outputCacheProfiles>
    <clear />
  </outputCacheProfiles>
</outputCacheSettings>

Пример

В следующем примере страница кэшируется на сервере только на одну минуту. Сохраняются разные версии страницы в зависимости от типа браузера и его основной версии.

<outputCacheSettings>
  <outputCacheProfiles>
    <add name="ServerOnly" 
      duration="60" 
      varyByCustom="browser" 
      location="Server" />
  </outputCacheProfiles>
</outputCacheSettings>

При разработке страницы, для которой нужен такой способ кэширования, на страницу необходимо добавить следующую директиву:

<%@ OutputCache CacheProfile="ServerOnly" %>

Дополнительные сведения см. в разделе @ OutputCache.

Сведения об элементе

Обработчик раздела конфигурации	System.Web.Configuration.OutputCacheSettingsSection
Элемент конфигурации	SystemWebCachingSectionGroup.OutputCacheSettings
Настраиваемые расположения	Machine.config Файл Web.config корневого уровня Файл Web.config уровня приложения
Требования	IIS версий 5.0, 5.1 и 6.0 Платформа .NET Framework 2.0 Visual Studio 2005

См. также

Задачи

Пошаговое руководство. Использование кэширования выходных данных для улучшения производительности веб-узла

Практическое руководство. Настройка отдельных каталогов с помощью параметров расположения

Пошаговое руководство. Отключение параметров конфигурации ASP.NET

Ссылки

Элемент system.web (схема параметров ASP.NET)

Элемент configuration (схема общих параметров)

Элемент caching (схема параметров ASP.NET)

Элемент outputCacheProfiles для элемента outputCacheSettings для элемента caching (схема параметров ASP.NET)

System.Configuration

System.Web.Configuration

Основные понятия

Общие сведения о кэшировании в ASP.NET

Иерархия и наследование файла конфигурации ASP.NET

Настройка обеспечения безопасности ASP.NET

Сценарии конфигурации ASP.NET

Другие ресурсы

Общие параметры конфигурации (ASP.NET)

Параметры конфигурации ASP.NET

Администрирование веб-сайта ASP.NET

Файлы конфигурации ASP.NET

Конфигурационный API-интерфейс настройки ASP.NET