Elemento <namedCaches> (Configurações de cache)

Artigo
05/09/2023

Especifica a coleção de definições de configuração para as instâncias nomeadas de MemoryCache. A propriedade NamedCaches referencia a coleção de definições de configuração de um ou mais elementos namedCaches do arquivo de configuração.

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

Syntax

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

Tipo

None

Atributos e elementos

As seções a seguir descrevem atributos, elementos filho e elementos pai.

Atributos

Atributo	Descrição
`cacheMemoryLimitMegabytes`	Um valor inteiro que especifica o tamanho máximo permitido, em megabytes, até o qual uma instância de um MemoryCache pode crescer. O valor padrão é 0, o que significa que a heurística de dimensionamento automático da classe MemoryCache é usada por padrão.
`name`	O nome do cache.
`physicalMemoryLimitPercentage`	Um valor inteiro entre 0 e 100 que especifica o percentual máximo de memória do computador fisicamente instalada que pode ser consumida pelo cache. O valor padrão é 0, o que significa que a heurística de dimensionamento automático da classe MemoryCache é usada por padrão.
`pollingInterval`	Um valor que indica o intervalo de tempo após o qual a implementação de cache compara a carga de memória atual com os limites de memória absoluto e baseado em percentual que são definidos para a instância do cache. Esse valor é inserido no formato "HH:MM:SS".

Elementos filho

Elemento	Descrição
<add>	Adiciona um cache nomeado à coleção de `namedCaches` para um cache de memória.
<clear>	Limpa a coleção `namedCaches` de um cache de memória.
<remove>	Remove uma entrada de cache nomeado da coleção de `namedCaches` para um cache de memória.

Elementos pai

Elemento	Descrição
<configuração>	Especifica o elemento raiz em todos os arquivos de configuração usados pelo Common Language Runtime e pelos aplicativos do .NET Framework.
<memoryCache>	Define um elemento usado para configurar um cache baseado na classe MemoryCache.
<system.runtime.caching>	Contém tipos que permitem implementar o cache de saída em aplicativos integrados ao .NET Framework.

Comentários

A seção de configuração do cache de memória do arquivo Web.config pode conter os atributos add, remove e clear para a coleção namedCaches. Cada entrada namedCaches é identificada exclusivamente pelo atributo name.

Você pode recuperar instâncias de entradas de cache de memória referenciando as informações nos arquivos de configuração do aplicativo. Por padrão, apenas a instância de cache padrão tem uma entrada no arquivo de configuração. A instância de cache padrão é a instância retornada da propriedade Default.

Se você definir o atributo de nome como "Padrão", o elemento usará a instância de cache de memória padrão.

Exemplo

O exemplo a seguir mostra como definir o nome do cache para o nome de entrada de cache padrão definindo o atributo name como "Padrão".

O atributo cacheMemoryLimitMegabytes e o atributo physicalMemoryPercentage são definidos como zero. Definir esses atributos como zero significa que a heurística de dimensionamento automático da classe MemoryCache é usada. A implementação do cache compara a carga de memória atual com os limites de memória absolutos e baseados em percentual a cada dois minutos.

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

Compartilhar via