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

Настраивает параметры кэширования для веб-приложения.

<caching>
   <cache>...</cache>
   <outputCache>...</outputCache>
   <outputCacheSettings>...</outputCacheSettings>
   <sqlCacheDependency>...</sqlCacheDependency>
</caching>

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

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

Атрибуты

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

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

Элемент

Описание

Cache

Необязательный элемент.

Задает параметры глобального кэша приложений.

outputCache

Необязательный элемент.

Задает параметры кэша вывода на уровне приложения.

outputCacheSettings

Необязательный элемент.

Задает параметры кэша вывода, которые можно применить к страницам в приложении.

sqlCacheDependency

Необязательный элемент.

Настраивает зависимости кэш-памяти SQL для приложения ASP.NET.

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

Элемент

Описание

configuration

Обязательный корневой элемент любого файла конфигурации, используемого средой CLR и приложениями .NET Framework.

System.web

Указывает корневой элемент для параметров конфигурации ASP.NET в файле конфигурации. Содержит элементы конфигурации для настройки веб-приложений ASP.NET и управления поведением этих приложений.

Заметки

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

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

<caching>
  <cache disableMemoryCollection = "false" 
    disableExpiration = "false" 
    privateBytesLimit = "0" 
    percentagePhysicalMemoryUsedLimit = "90" 
    privateBytesPollTime = "00:02:00"/>

  <outputCache enableOutputCache = "true" 
    enableFragmentCache = "true" 
    sendCacheControlHeader = "true" 
    omitVaryStar = "false" >
  </outputCache>

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

  <sqlCacheDependency enabled = "true" 
    pollTime = "60000">
    <databases>
       <clear />
      <add name = "" 
        connectionStringName = "" 
        pollTime = "60000"/>
    </databases>
  </sqlCacheDependency>

</caching>

Пример

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

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

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

<%@ OutputCache CacheProfile="ServerOnly" %>

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

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

Обработчик раздела конфигурации

System.Web.Configuration.CacheSection

System.Web.Configuration.OutputCacheSection

System.Web.Configuration.OutputCacheSettingsSection

System.Web.Configuration.SqlCacheDependencySection

Элемент конфигурации

System.Web.Configuration.SystemWebCachingSectionGroup

Настраиваемые расположения.

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 (схема общих параметров)

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

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

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

Элемент sqlCacheDependency для элемента 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