<memoryCache Element (Cache Settings) (Elemento memoryCache> [Definições da Cache])

Artigo
05/09/2023

Define um elemento que é utilizado para configurar uma cache baseada na MemoryCache classe . A MemoryCacheElement classe define um elemento memoryCache que pode utilizar para configurar a cache. Podem ser utilizadas várias instâncias da MemoryCache classe numa única aplicação. Cada memoryCache elemento no ficheiro de configuração pode conter definições para uma instância nomeada MemoryCache .

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

Syntax

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

Tipo

MemoryCache classe.

Atributos e Elementos

As secções seguintes descrevem atributos, elementos subordinados e elementos principais.

Atributos

Atributo	Descrição
`CacheMemoryLimitMegabytes`	O tamanho máximo da memória, em megabytes, ao qual uma instância de um MemoryCache objeto pode aumentar. O valor predefinido é 0, o que significa que a MemoryCache heurística de tamanho automático da classe é utilizada por predefinição.
`Name`	O nome da configuração da cache.
`PhysicalMemoryLimitPercentage`	A percentagem de memória física que pode ser utilizada pela cache. O valor predefinido é 0, o que significa que a MemoryCache heurística de tamanho automático da classe é utilizada por predefinição.
`PollingInterval`	Um valor que indica o intervalo de tempo após o qual a implementação da cache compara a carga de memória atual com os limites de memória absolutos e baseados em percentagem definidos para a instância de cache. O valor é introduzido no formato "HH:MM:SS".

Elementos Subordinados

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

Elementos Principais

Elemento	Descrição
<configuração>	Especifica o elemento raiz em todos os ficheiros de configuração utilizados pelo runtime de linguagem comum e .NET Framework aplicações.
<system.runtime.caching>	Contém tipos que lhe permitem implementar a colocação em cache de saída em aplicações incorporadas no .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 ficheiros de configuração da aplicação. A secção de configuração memoryCache contém uma namedCaches coleção de configuração.

Quando um objeto de cache baseado na memória é inicializado, tenta primeiro encontrar uma namedCaches entrada que corresponda ao nome no parâmetro que é transmitido para o construtor da cache de memória. Se for encontrada uma namedCaches entrada, as informações de consulta e gestão de memória são obtidas a partir do ficheiro de configuração.

Em seguida, o processo de inicialização determina se alguma entrada de configuração foi substituída, utilizando a coleção opcional de pares de nomes/valores de informações de configuração no construtor. Se transmitir qualquer um dos seguintes valores na coleção de pares nome/valor, estes valores substituem as informações obtidas a partir do ficheiro de configuração:

Exemplo

O exemplo seguinte mostra como definir o nome do objeto para o nome de MemoryCache objeto de cache predefinido ao definir o name atributo como "Predefinido".

O cacheMemoryLimitMegabytes atributo e o physicalMemoryLimitPercentage atributo estão definidos como zero. Definir estes atributos como zero significa que a MemoryCache heurística de dimensionamento automático é utilizada por predefinição. A implementação da cache deve comparar a carga de memória atual com os limites de memória absolutos e baseados em percentagem 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>

Partilhar via