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

2025-08-13

Определяет элемент, используемый для настройки кэша, основанного MemoryCache на классе. Класс MemoryCacheElement определяет элемент memoryCache , который можно использовать для настройки кэша. В одном приложении можно использовать несколько экземпляров MemoryCache класса. Каждый memoryCache элемент в файле конфигурации может содержать параметры именованного MemoryCache экземпляра.

<конфигурация>
<system.runtime.caching>
<memoryCache>

Синтаксис

<memoryCache>
    <namedCaches>  
        <!-- child elements -->  
    </namedCaches>
</memoryCache>

Тип

класс MemoryCache.

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

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

Атрибуты

Свойство	Описание
`CacheMemoryLimitMegabytes`	Максимальный размер памяти в мегабайтах, на который может расти экземпляр MemoryCache объекта. Значение по умолчанию равно 0, что означает, что MemoryCache автомасштабируемая эвристика класса используется по умолчанию. (Этот параметр действует только в .Net Framework.)
`Name`	Имя конфигурации кэша.
`PhysicalMemoryLimitPercentage`	процент общего использования физической памяти в системе (по всем процессам), с которым кэш начнет вытеснение записей. Значение по умолчанию равно 0, что означает, что MemoryCache автомасштабируемая эвристика класса используется по умолчанию.
`PollingInterval`	Значение, указывающее интервал времени, после которого реализация кэша сравнивает текущую нагрузку памяти с абсолютными и процентными ограничениями памяти, заданными для экземпляра кэша. Значение введите в формате HH:MM:SS.

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

Элемент	Описание
<namedCaches>	Содержит коллекцию параметров конфигурации для экземпляра `namedCache` .

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

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

Замечания

Класс MemoryCache представляет собой конкретную реализацию абстрактного ObjectCache класса. Экземпляры MemoryCache класса можно предоставить с информацией о конфигурации из файлов конфигурации приложения. Раздел конфигурации memoryCache содержит namedCaches коллекцию конфигураций.

При инициализации объекта кэша на основе памяти сначала пытается найти namedCaches запись, соответствующую имени в параметре, переданном конструктору кэша памяти. namedCaches Если запись найдена, данные опроса и управления памятью извлекаются из файла конфигурации.

Затем процесс инициализации определяет, были ли переопределены все записи конфигурации, используя необязательную коллекцию пар имен и значений сведений о конфигурации в конструкторе. Если передать одно из следующих значений в коллекции пар "имя-значение", эти значения переопределяют сведения, полученные из файла конфигурации:

Пример

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

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

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

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