Compartilhar via

<memoryCache> Elemento (Configurações de Cache)

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

<configuração>
   <system.runtime.caching>
     <memoryCache>

Sintaxe

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

Tipo

MemoryCache classe.

Atributos e Elementos

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

Atributos

Atributo Descrição
CacheMemoryLimitMegabytes O tamanho máximo da memória, em megabytes, para o qual uma instância de um MemoryCache objeto pode crescer. O valor padrão é 0, o que significa que a MemoryCache heurística de dimensionamento automático da classe é usada por padrão. (Essa configuração só é eficaz no .Net Framework.)
Name O nome da configuração de cache.
PhysicalMemoryLimitPercentage percentual do uso total de memória física no sistema (por todos os processos) em que o cache começará a remover entradas. O valor padrão é 0, o que significa que a MemoryCache heurística de dimensionamento automático da classe é usada por padrão.
PollingInterval Um valor que indica o intervalo de tempo após o qual a implementação do cache compara a carga de memória atual com os limites de memória absolutos e baseados em porcentagem definidos para a instância de cache. O valor é inserido no formato "HH:MM:SS".

Elementos filho

Elemento Descrição
<namedCaches> Contém uma coleção de configurações para a namedCache instância.

Elementos pai

Elemento Descrição
<configuração> Especifica o elemento raiz em cada arquivo de configuração 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.

Observações

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

Quando um objeto de cache baseado em memória é inicializado, ele tenta primeiro encontrar uma namedCaches entrada que corresponda ao nome no parâmetro que é passado para o construtor de cache de memória. Se uma namedCaches entrada for encontrada, 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 MemoryCache objeto para o nome do objeto de cache padrão definindo o name atributo como "Padrão".

O cacheMemoryLimitMegabytes atributo e o physicalMemoryLimitPercentage atributo são definidos como zero. Definir esses atributos como zero significa que a MemoryCache heurística de dimensionamento automático é 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 porcentagem 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>

Consulte também

  • Last updated on