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

Статья
11/16/2008

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

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

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

См. также

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

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

Атрибуты

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

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

Заметки

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

Пример

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

См. также

Задачи

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

Ссылки

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

Дополнительные ресурсы