Compartilhar via


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

Especifica uma coleção de configurações para as instâncias nomeadas MemoryCache . A NamedCaches propriedade faz referência à coleção de configurações de um ou mais namedCaches elementos do arquivo de configuração.

<configuração>
   <system.runtime.caching>
     <Memorycache>
       <Namedcaches>

Sintaxe

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

Tipo

None

Atributos e elementos

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

Attributes

Attribute Description
cacheMemoryLimitMegabytes Um valor inteiro que especifica o tamanho máximo permitido, em megabytes, para o qual uma instância de um MemoryCache pode crescer. O valor padrão é 0, o que significa que a heurística de dimensionamento automático da MemoryCache classe é usada por padrão.
name O nome do cache.
physicalMemoryLimitPercentage Um valor inteiro entre 0 e 100 que especifica o percentual máximo de memória do computador fisicamente instalada que pode ser consumida pelo cache. O valor padrão é 0, o que significa que a heurística de dimensionamento automático da MemoryCache 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. Esse valor é inserido no formato "HH:MM:SS".

Elementos filho

Elemento Description
<adicionar> Adiciona um cache nomeado à namedCaches coleção para um cache de memória.
<claro> Limpa a namedCaches coleção de um cache de memória.
<retirar> Remove uma entrada de cache nomeada da namedCaches coleção para um cache de memória.

Elementos pai

Elemento Description
<configuração> Especifica o elemento raiz em cada arquivo de configuração usado pelo common language runtime e aplicativos do .NET Framework.
<Memorycache> Define um elemento usado para configurar um cache baseado na MemoryCache classe.
<system.runtime.caching> Contém tipos que permitem implementar o cache de saída em aplicativos integrados ao .NET Framework.

Observações

A seção de configuração de cache de memória do arquivo Web.config pode conter add, removee clear atributos para a namedCaches coleção. Cada namedCaches entrada é identificada exclusivamente pelo name atributo.

Você pode recuperar instâncias de entradas de cache de memória fazendo referência às informações nos arquivos de configuração do aplicativo. Por padrão, somente a instância de cache padrão tem uma entrada no arquivo de configuração. A instância de cache padrão é a instância retornada da Default propriedade.

Se você definir o atributo de nome como "Padrão", o elemento usará a instância de cache de memória padrão.

Example

O exemplo a seguir mostra como definir o nome do cache para o nome de entrada de cache padrão definindo o name atributo como "Padrão".

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