Compartir a través de

<memoryCache> Elemento (configuración de caché)

Define un elemento que se usa para configurar una memoria caché basada en la MemoryCache clase . La MemoryCacheElement clase define un elemento memoryCache que puede usar para configurar la memoria caché. Se pueden usar varias instancias de la MemoryCache clase en una sola aplicación. Cada memoryCache elemento del archivo de configuración puede contener valores para una instancia con nombre MemoryCache .

<configuración>
   <system.runtime.caching>
     <memoryCache>

Sintaxis

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

Tipo

Clase MemoryCache.

Atributos y elementos

En las secciones siguientes se describen los atributos, los elementos secundarios y los elementos primarios.

Atributos

Atributo Descripción
CacheMemoryLimitMegabytes Tamaño máximo de memoria, en megabytes, que una instancia de un MemoryCache objeto puede crecer. El valor predeterminado es 0, lo que significa que la heurística de tamaño automático de la MemoryCache clase se usa de forma predeterminada. (Esta configuración solo es efectiva en .Net Framework).
Name Nombre de la configuración de caché.
PhysicalMemoryLimitPercentage porcentaje del uso total de memoria física en el sistema (por todos los procesos) en el que la memoria caché comenzará a expulsar las entradas. El valor predeterminado es 0, lo que significa que la heurística de tamaño automático de la MemoryCache clase se usa de forma predeterminada.
PollingInterval Valor que indica el intervalo de tiempo después del cual la implementación de la memoria caché compara la carga de memoria actual con los límites de memoria absolutos y basados en porcentajes establecidos para la instancia de caché. El valor se escribe en formato "HH:MM:SS".

Elementos secundarios

Elemento Descripción
<namedCaches> Contiene una colección de opciones de configuración para la namedCache instancia de .

Elementos primarios

Elemento Descripción
<configuración> Especifica el elemento raíz de cada archivo de configuración que usan las aplicaciones de Common Language Runtime y .NET Framework.
<system.runtime.caching> Contiene tipos que permiten implementar el almacenamiento en caché de salida en aplicaciones integradas en .NET Framework.

Observaciones

La MemoryCache clase es una implementación concreta de la clase abstracta ObjectCache . Las instancias de la MemoryCache clase se pueden proporcionar con información de configuración de los archivos de configuración de la aplicación. La sección de configuración memoryCache contiene una namedCaches colección de configuración.

Cuando se inicializa un objeto de caché basado en memoria, primero intenta encontrar una namedCaches entrada que coincida con el nombre del parámetro que se pasa al constructor de caché de memoria. Si se encuentra una namedCaches entrada, la información de sondeo y administración de memoria se recupera del archivo de configuración.

A continuación, el proceso de inicialización determina si se invalidaron las entradas de configuración mediante la colección opcional de pares nombre-valor de la información de configuración en el constructor. Si pasa cualquiera de los siguientes valores en la colección de pares nombre-valor, estos valores invalidan la información obtenida del archivo de configuración:

Ejemplo

En el ejemplo siguiente se muestra cómo establecer el nombre del objeto en el nombre del MemoryCache objeto de caché predeterminado estableciendo el name atributo en "Default".

El cacheMemoryLimitMegabytes atributo y el physicalMemoryLimitPercentage atributo se establecen en cero. Establecer estos atributos en cero significa que la MemoryCache heurística de ajuste automático se usa de forma predeterminada. La implementación de la memoria caché debe comparar la carga de memoria actual con los límites de memoria absolutos y basados en porcentajes cada dos minutos.

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

Consulte también

  • Last updated on