Partilhar via

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

Define um elemento que é 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 de 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 as MemoryCache heurísticas de tamanho automático da classe são usadas por padrão. (Essa configuração só é efetiva no .Net Framework.)
Name O nome da configuração de cache.
PhysicalMemoryLimitPercentage porcentagem do uso total de memória física no sistema (por todos os processos) na qual o cache começará a remover entradas. O valor padrão é 0, o que significa que as MemoryCache heurísticas de tamanho automático da classe são usadas 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 definições de configuração 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 pelos aplicativos do .NET Framework.
<system.runtime.caching> Contém tipos que permitem implementar o cache de saída em aplicativos que são incorporados 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 coleção de namedCaches configurações.

Quando um objeto de cache baseado em memória é inicializado, ele primeiro tenta 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.

O processo de inicialização, em seguida, determina se quaisquer entradas de configuração foram substituídas, usando a coleção opcional de pares 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 MemoryCache nome do objeto para o nome do objeto de cache padrão definindo o name atributo como "Default".

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

Ver também

  • Last updated on