Elemento <memoryCache> (configurações do cache)

Artigo
05/09/2023

Define um elemento usado para configurar um cache baseado na classe MemoryCache. A classe define MemoryCacheElement um elemento memoryCache que você pode usar para configurar o cache. Várias instâncias da classe MemoryCache podem ser usadas em um único aplicativo. Cada elemento memoryCache no arquivo de configuração pode conter configurações para uma instância nomeada MemoryCache.

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

Syntax

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

Tipo

classe MemoryCache.

Atributos e elementos

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

Atributos

Atributo	Descrição
`CacheMemoryLimitMegabytes`	O tamanho máximo de memória, em megabytes, que uma instância de um objeto MemoryCache pode atingir. 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 da configuração de cache.
`PhysicalMemoryLimitPercentage`	O percentual de memória física que pode ser usado 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. O valor é inserido no formato "HH:MM:SS".

Elementos filho

Elemento	Descrição
<namedCaches>	Contém um conjunto de definições de configuração para a instância `namedCache`.

Elementos pai

Elemento	Descrição
<configuração>	Especifica o elemento raiz em todos os arquivos de configuração que é usado pelo common language runtime e aplicativos do .NET Framework.
<system.runtime.caching>	Contém tipos que permitem implementar o cache de saída em aplicativos integrados ao .NET Framework.

Comentários

A classe MemoryCache é uma implementação concreta da classe ObjectCache abstrata. As instâncias da classe MemoryCache podem ser fornecidas com informações de configuração de arquivos de configuração do aplicativo. A seção de configuração memoryCache contém uma coleção de configurações de namedCaches.

Quando um objeto de cache baseado em memória é inicializado, ele primeiro tenta encontrar uma entrada namedCaches que corresponda ao nome no parâmetro passado para o construtor do cache de memória. Se encontrar uma entrada namedCaches, as informações de sondagem e gerenciamento de memória serão recuperadas do arquivo de configuração.

Em seguida, o processo de inicialização determina se as entradas de configuração foram substituídas usando a coleção opcional de pares de nome/valor de informações de configuração no construtor. Se você passar qualquer um dos seguintes valores na coleção de pares nome/valor, esses valores substituirão as informações obtidas do arquivo de configuração:

Exemplo

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

O atributo cacheMemoryLimitMegabytes e o atributo physicalMemoryLimitPercentage são definidos como zero. A definição desses atributos como zero significa que a heurística de dimensionamento automático de MemoryCache é usada por padrão. A implementação do cache deve comparar 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