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

Задает коллекцию параметров конфигурации для именованных MemoryCache экземпляров.Specifies a collection of configuration settings for the named MemoryCache instances. NamedCachesСвойство ссылается на коллекцию параметров конфигурации из одного или нескольких namedCaches элементов файла конфигурации.The NamedCaches property references the collection of configuration settings from one or more namedCaches elements of the configuration file.

<configuration>
  <system.runtime.caching>
    <memoryCache>
      <namedCaches>

СинтаксисSyntax

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

ТипType

None

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

В следующих разделах описаны атрибуты, дочерние и родительские элементы.The following sections describe attributes, child elements, and parent elements.

АтрибутыAttributes

АтрибутAttribute ОписаниеDescription
cacheMemoryLimitMegabytes Целочисленное значение, указывающее максимально допустимый размер (в мегабайтах), MemoryCache до которого может увеличиваться экземпляр.An integer value that specifies the maximum allowable size, in megabytes, that an instance of a MemoryCache can grow to. Значение по умолчанию — 0. Это означает, что по умолчанию используется эвристика автоподбора размера MemoryCache класса.The default value is 0, which means that the autosizing heuristics of the MemoryCache class are used by default.
name Имя кэша.The name of the cache.
physicalMemoryLimitPercentage Целочисленное значение от 0 до 100, которое указывает максимальный процент физической памяти компьютера, который может потребляться кэшем.An integer value between 0 and 100 that specifies the maximum percentage of physically installed computer memory that can be consumed by the cache. Значение по умолчанию — 0. Это означает, что по умолчанию используется эвристика автоподбора размера MemoryCache класса.The default value is 0, which means that the autosizing heuristics of the MemoryCache class are used by default.
pollingInterval Значение, указывающее интервал, по истечении которого реализация кэша сравнивает текущую загрузку памяти с абсолютными и процентными ограничениями по памяти, заданными для данного экземпляра кэша.A value that indicates the time interval after which the cache implementation compares the current memory load against the absolute and percentage-based memory limits that are set for the cache instance. Это значение указывается в формате "чч: мм: СС".This value is entered in "HH:MM:SS" format.

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

ЭлементElement ОписаниеDescription
<add> Добавляет именованный кэш к коллекции namedCaches для кэша памяти.Adds a named cache to the namedCaches collection for a memory cache.
<clear> Очищает коллекцию namedCaches для кэша памяти.Clears the namedCaches collection for a memory cache.
<remove> Удаляет элемент именованного кэша из коллекции namedCaches для кэша памяти.Removes a named cache entry from the namedCaches collection for a memory cache.

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

ЭлементElement ОписаниеDescription
<configuration> Указывает корневой элемент в каждом файле конфигурации, который используется средой CLR и платформа .NET Framework приложениями.Specifies the root element in every configuration file that is used by the common language runtime and .NET Framework applications.
<memoryCache> Определяет элемент, используемый для настройки кэша, который основан на классе MemoryCache .Defines an element that is used to configure a cache that is based on the MemoryCache class.
<system.runtime.caching> Содержит типы, позволяющие реализовать кэширование вывода в приложениях, встроенных в платформа .NET Framework.Contains types that let you implement output caching in applications that are built into the .NET Framework.

RemarksRemarks

Раздел конфигурации кэша памяти файла Web.config может содержать add remove атрибуты, и clear для namedCaches коллекции.The memory cache configuration section of the Web.config file can contain add, remove, and clear attributes for the namedCaches collection. Каждая namedCaches запись уникально идентифицируется name атрибутом.Each namedCaches entry is uniquely identified by the name attribute.

Экземпляры записей кэша памяти можно получить, обратившись к сведениям в файлах конфигурации приложения.You can retrieve instances of memory cache entries by referencing the information in the application configuration files. По умолчанию в файле конфигурации содержится запись только для экземпляра кэша по умолчанию.By default, only the default cache instance has an entry in the configuration file. Экземпляром кэша по умолчанию является экземпляр, который возвращается из Default Свойства.The default cache instance is the instance that is returned from the Default property.

Если для атрибута name задано значение Default, то элемент использует экземпляр кэша памяти по умолчанию.If you set the name attribute to "default", the element uses the default memory cache instance.

ПримерExample

В следующем примере показано, как задать имя кэша в качестве имени записи кэша по умолчанию, задав name для атрибута значение Default.The following example shows how to set the name of the cache to the default cache entry name by setting the name attribute to "default".

Атрибутам cacheMemoryLimitMegabytes и physicalMemoryPercentage присваивается нулевое значение.The cacheMemoryLimitMegabytes attribute and the physicalMemoryPercentage attribute are set to zero. Установка этих атрибутов равным нулю означает, что используется эвристический подход автоподбора размера MemoryCache класса.Setting these attributes to zero means that the autosizing heuristics of the MemoryCache class are used. Реализация кэша сравнивает текущую загрузку памяти с абсолютными и процентными ограничениями памяти каждые две минуты.The cache implementation compares the current memory load against the absolute and percentage-based memory limits every two minutes.

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

См. такжеSee also