<Элемент namedCaches> (параметры кэша)

Статья
04/08/2023

Задает коллекцию параметров конфигурации для именованных MemoryCache экземпляров. Свойство NamedCaches ссылается на коллекцию параметров конфигурации из одного или namedCaches нескольких элементов файла конфигурации.

<Конфигурации>
  <system.runtime.caching>
    <Memorycache>
      <namedCaches>

Синтаксис

<namedCaches>  
  <add name="Default"/>
</namedCaches>

Тип

None

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

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

Атрибуты

Атрибут	Описание
`cacheMemoryLimitMegabytes`	Целочисленное значение, указывающее максимальный допустимый размер (в мегабайтах MemoryCache ), до который может увеличиться экземпляр . Значение по умолчанию равно 0, что означает, что по умолчанию используется эвристика MemoryCache автомасштабирования класса.
`name`	Имя кэша.
`physicalMemoryLimitPercentage`	Целочисленное значение от 0 до 100, указывающее максимальный процент физически установленной памяти компьютера, которая может использоваться кэшем. Значение по умолчанию равно 0, что означает, что по умолчанию используется эвристика MemoryCache автомасштабирования класса.
`pollingInterval`	Значение, указывающее интервал, по истечении которого реализация кэша сравнивает текущую загрузку памяти с абсолютными и процентными ограничениями по памяти, заданными для данного экземпляра кэша. Это значение вводится в формате "ЧЧ:ММ:СС".

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

Элемент	Описание
<добавление>	Добавляет именованный кэш к коллекции `namedCaches` для кэша памяти.
<Ясно>	Очищает коллекцию `namedCaches` для кэша памяти.
<Удалить>	Удаляет элемент именованного кэша из коллекции `namedCaches` для кэша памяти.

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

Элемент	Описание
<configuration>	Задает корневой элемент в каждом файле конфигурации, который используется средой CLR и платформа .NET Framework приложениями.
<Memorycache>	Определяет элемент, используемый для настройки кэша, который основан на классе MemoryCache .
<system.runtime.caching>	Содержит типы, позволяющие реализовать кэширование выходных данных в приложениях, встроенных в платформа .NET Framework.

Раздел конфигурации кэша памяти файла Web.config может содержать addатрибуты , removeи clear для namedCaches коллекции. Каждая namedCaches запись уникально идентифицируется атрибутом name .

Вы можете получить экземпляры записей кэша памяти, ссылаясь на сведения в файлах конфигурации приложения. По умолчанию только экземпляр кэша по умолчанию имеет запись в файле конфигурации. Экземпляр кэша по умолчанию — это экземпляр, возвращаемый свойством Default .

Если для атрибута name задано значение Default, элемент использует экземпляр кэша памяти по умолчанию.

Пример

В следующем примере показано, как задать имя кэша в качестве имени записи кэша по умолчанию, задав для атрибута name значение "Default".

Атрибутам cacheMemoryLimitMegabytes и physicalMemoryPercentage присваивается нулевое значение. Установка для этих атрибутов нулевого значения означает, что используется эвристика автомасштабирования MemoryCache класса . Реализация кэша сравнивает текущую нагрузку памяти с абсолютными и процентными ограничениями памяти каждые две минуты.

<configuration>  
  
  <system.runtime.caching>  
    <memoryCache>  
      <namedCaches>  
          <add name="Default"
               cacheMemoryLimitMegabytes="0"
               physicalMemoryLimitPercentage="0"  
               pollingInterval="00:02:00" />  
      </namedCaches>  
    </memoryCache>  
  </system.runtime.caching>  
  
</configuration>

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