<add> Element for <namedCaches>

Article
02/04/2013

Adds a namedCache entry to the namedCaches collection for a memory cache.

<system.runtime.caching> Element (Cache Settings)
  <memoryCache> Element (Cache Settings)
    <namedCaches> Element (Cache Settings)
      <add> Element for <namedCaches>

<namedCaches>
    <add name="default" />
      <!-- child elements -->
 </namedCaches>

None

Attributes and Elements

The following sections describe attributes, child elements, and parent elements.

Attributes

Attribute	Description
CacheMemoryLimitMegabytes	An integer value that specifies the maximum allowed size (in megabytes) that an instance of a MemoryCache can grow to. The default value is 0, which means that the MemoryCache class's autosizing heuristics are used by default.
Name	The name of the cache.
PhysicalMemoryLimitPercentage	An integer value between 0 and 100 that specifies the maximum percentage of physically installed computer memory that can be consumed by the cache. The default value is 0, which means that the MemoryCache class's autosizing heuristics 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

None

Parent Elements

Element	Description
<namedCaches>	Contains a collection of configuration settings for the named MemoryCache instances.

Remarks

The add element adds an entry to the namedCaches collection for a memory cache. You can use the clear element before you use the add element to be certain that there are no other named caches in the collection. This element can be used in the machine.config file and in the Web.config file.

Example

The following example shows how to define settings for the default namedCache entry to the namedCaches collection for a memory cache.

<configuration>

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

</configuration>