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

Статья
08/11/2011

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

<cache disableMemoryCollection="true|false" 
       disableExpiration="true|false" 
       privateBytesLimit="number" 
       percentagePhysicalMemoryUsedLimit="number" 
       privateBytesPollTime="HH:MM:SS" />

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

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

Атрибуты

Атрибут	Описание
disableMemoryCollection	Необязательный атрибут элемента Boolean. Возвращает или задает значение, указывающее, отключена ли очистка кэша, которая происходит в случае недостатка памяти.
disableExpiration	Необязательный атрибут Boolean. Возвращает или задает значение, указывающее, отключено ли истечение срока хранения в кэше. Когда эта функция отключена, элементы хранятся в кэше в течение неограниченного времени, и элементы с истекшим сроком хранения не удаляются из кэша в фоновом режиме.
privateBytesLimit	Необязательный атрибут Int64. Возвращает или задает значение, указывающее максимальный объем единолично используемой приложением памяти в байтах, по превышении которого начинается удаление из кэша элементов с истекшим сроком хранения и предпринимается попытка высвободить память. Этот предел включает как память, используемую кэшем, так и обычную память, потребляемую работающим приложением. Нулевое значение предписывает ASP.NET использовать собственную эвристику для определения момента, когда следует начать высвобождение памяти.
percentagePhysicalMemoryUsedLimit	Необязательный атрибут Int32. Возвращает или задает значение, указывающее максимальную долю физической памяти компьютера в процентах, которая может быть занята, прежде чем начнется удаление из кэша элементов с истекшим сроком хранения и будет предпринята попытка высвободить память. Обратите внимание, что данный предел относится к общему объему занимаемой физической памяти. Значение, равное 0, приводит к немедленному удалению записей сразу после их вставки.
privateBytesPollTime	Необязательный атрибут TimeSpan. Возвращает или задает значение, указывающее временной интервал между запросами объема единолично занимаемой приложением памяти.

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

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

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

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

Заметки

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

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

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

Пример

В следующем примере устанавливаются глобальные параметры кэша для приложения ASP.NET.

<cache disableMemoryCollection = "false" 
  disableExpiration = "false" 
  privateBytesLimit = "20971520" 
  percentagePhysicalMemoryUsedLimit = 60" 
  privateBytesPollTime = "00:01:00"/>

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

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

См. также

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

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

Атрибуты

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

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

Заметки

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

Пример

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

См. также

Задачи

Ссылки

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

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

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