Compartilhar via


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

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>  

Confira também