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

Artigo
04/11/2023

Especifica uma coleção de definições de configuração para as instâncias nomeadas MemoryCache . A NamedCaches propriedade referencia a coleção de definições de configuração de um ou mais namedCaches elementos do ficheiro de configuração.

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

Syntax

<namedCaches>  
  <add name="Default"/>
</namedCaches>

Tipo

None

Atributos e Elementos

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

Atributos

Atributo	Descrição
`cacheMemoryLimitMegabytes`	Um valor inteiro que especifica o tamanho máximo permitido, em megabytes, ao qual uma instância de um MemoryCache pode aumentar. O valor predefinido é 0, o que significa que a heurística de autodimensionamento da MemoryCache classe é utilizada por predefinição.
`name`	O nome da cache.
`physicalMemoryLimitPercentage`	Um valor inteiro entre 0 e 100 que especifica a percentagem máxima de memória física instalada do computador que pode ser consumida pela cache. O valor predefinido é 0, o que significa que a heurística de autodimensionamento da MemoryCache 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. Este valor é introduzido no formato "HH:MM:SS".

Elementos Subordinados

Elemento	Descrição
<adicionar>	Adiciona uma cache com nome à `namedCaches` coleção de uma cache de memória.
<limpar>	Limpa a `namedCaches` coleção de uma cache de memória.
<remover>	Remove uma entrada de cache nomeada da `namedCaches` coleção para uma cache de memória.

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.
<memoryCache>	Define um elemento que é utilizado para configurar uma cache baseada na MemoryCache classe .
<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 secção de configuração da cache de memória do ficheiro Web.config pode conter addatributos , removee clear para a namedCaches coleção. Cada namedCaches entrada é identificada exclusivamente pelo name atributo .

Pode obter instâncias de entradas de cache de memória ao referenciar as informações nos ficheiros de configuração da aplicação. Por predefinição, apenas a instância de cache predefinida tem uma entrada no ficheiro de configuração. A instância de cache predefinida é a instância devolvida da Default propriedade .

Se definir o atributo de nome como "Predefinição", o elemento utiliza a instância de cache de memória predefinida.

Exemplo

O exemplo seguinte mostra como definir o nome da cache para o nome de entrada de cache predefinido ao definir o name atributo como "Predefinido".

O cacheMemoryLimitMegabytes atributo e o physicalMemoryPercentage atributo estão definidos como zero. Definir estes atributos como zero significa que a heurística de dimensionamento automático da MemoryCache classe é utilizada. A implementação da cache compara 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