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

Artículo
05/09/2023

Especifica una colección de valores de configuración para las instancias MemoryCache con nombre. La propiedad NamedCaches hace referencia a la colección de valores de configuración de uno o varios elementos namedCaches del archivo de configuración.

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

Sintaxis

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

Tipo

None

Atributos y elementos

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

Atributos

Atributo	Descripción
`cacheMemoryLimitMegabytes`	Valor entero que especifica el tamaño máximo permitido en megabytes hasta el que puede crecer una instancia de MemoryCache. El valor predeterminado es 0, lo que significa que se usa de forma predeterminada la heurística de ajuste automático de tamaño de la clase MemoryCache.
`name`	Nombre de la memoria caché.
`physicalMemoryLimitPercentage`	Valor entero entre 0 y 100 que especifica el porcentaje máximo de memoria del equipo instalada físicamente que puede consumir la memoria caché. El valor predeterminado es 0, lo que significa que se usa de forma predeterminada la heurística de ajuste automático de tamaño de la clase MemoryCache.
`pollingInterval`	Valor que indica el intervalo de tiempo después del cual la implementación de caché compara la carga de memoria actual con los límites de memoria absoluto y de porcentaje que están establecidos para la instancia de caché. Este valor se especifica con el formato "HH:MM:SS".

Elementos secundarios

Elemento	Descripción
<add>	Agrega una caché con nombre a la colección `namedCaches` de una caché en memoria.
<clear>	Borra la colección `namedCaches` de una caché en memoria.
<remove>	Quita una entrada de caché con nombre de la colección `namedCaches` de una caché en memoria.

Elementos primarios

Elemento	Descripción
<configuración>	Especifica el elemento raíz necesario en cada archivo de configuración utilizado por Common Language Runtime y las aplicaciones de .NET Framework.
<memoryCache>	Define un elemento que se usa para configurar una memoria caché basada en la clase MemoryCache .
<system.runtime.caching>	Contiene tipos que permiten implementar el almacenamiento en caché de resultados en las aplicaciones que están integradas en .NET Framework.

Comentarios

La sección de configuración de caché de memoria del archivo Web.config puede contener los atributos add, remove y clear para la colección namedCaches. Cada entrada namedCaches se identifica de forma única con el atributo name.

Puede recuperar instancias de entradas de caché de memoria haciendo referencia a la información de los archivos de configuración de la aplicación. De forma predeterminada, solo la instancia de caché predeterminada tiene una entrada en el archivo de configuración. La instancia de caché predeterminada es la instancia que devuelve la propiedad Default.

Si establece el atributo name en "Default", el elemento usa la instancia de caché de memoria predeterminada.

Ejemplo

En el ejemplo siguiente se muestra cómo establecer el nombre de la caché con el nombre de la entrada de la caché predeterminado al establecer el atributo name en "Default".

Los atributos cacheMemoryLimitMegabytes y physicalMemoryPercentage se establecen en cero. El hecho de establecer estos atributos en cero implica que se usará la heurística de ajuste automático de tamaño de la clase MemoryCache. La implementación de la memoria caché compara la carga de memoria actual con los límites de memoria absoluto y de porcentaje 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>

Compartir a través de