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

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

  • Статья

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

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

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

См. также

Задачи

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

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

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

Настройка кэша в ASP.NET

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

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

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

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

Ссылки

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

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

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

System.Configuration

System.Web.Configuration

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

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

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

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

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

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