Поделиться через

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

  • Статья

Обновлен: Ноябрь 2007

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

Элемент configuration (схема общих параметров)
  Элемент system.web (схема параметров ASP.NET)
    Элемент caching (схема параметров ASP.NET)
      Элемент outputCacheSettings для элемента caching (схема параметров 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

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

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

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

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

Сценарии конфигурации 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

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