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

  • Статья

Задает коллекцию параметров конфигурации для именованных 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>

См. также раздел