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

Especifica uma coleção de definições de configuração para as MemoryCache instâncias nomeadas.Specifies a collection of configuration settings for the named MemoryCache instances. A NamedCaches propriedade faz referência à coleção de definições de configuração de um ou mais namedCaches elementos do arquivo de configuração.The NamedCaches property references the collection of configuration settings from one or more namedCaches elements of the configuration file.

<configuration>
  <system.runtime.caching>
    <memoryCache>
      <namedCaches>

SyntaxSyntax

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

TipoType

None

Atributos e elementosAttributes and Elements

As seções a seguir descrevem atributos, elementos filho e elementos pai.The following sections describe attributes, child elements, and parent elements.

AtributosAttributes

AtributoAttribute DescriçãoDescription
cacheMemoryLimitMegabytes Um valor inteiro que especifica o tamanho máximo permitido, em megabytes, que uma instância de um MemoryCache pode aumentar para.An integer value that specifies the maximum allowable size, in megabytes, that an instance of a MemoryCache can grow to. O valor padrão é 0, o que significa que a heurística de dimensionamento automático da MemoryCache classe é usada por padrão.The default value is 0, which means that the autosizing heuristics of the MemoryCache class are used by default.
name O nome do cache.The name of the cache.
physicalMemoryLimitPercentage Um valor inteiro entre 0 e 100 que especifica a porcentagem máxima de memória do computador fisicamente instalada que pode ser consumida pelo cache.An integer value between 0 and 100 that specifies the maximum percentage of physically installed computer memory that can be consumed by the cache. O valor padrão é 0, o que significa que a heurística de dimensionamento automático da MemoryCache classe é usada por padrão.The default value is 0, which means that the autosizing heuristics of the MemoryCache class are used by default.
pollingInterval Um valor que indica o intervalo de tempo após o qual a implementação de cache compara a carga de memória atual com os limites de memória absolutos e baseados em percentual que são definidos para a instância de cache.A value that indicates the time interval after which the cache implementation compares the current memory load against the absolute and percentage-based memory limits that are set for the cache instance. Esse valor é inserido no formato "HH: MM: SS".This value is entered in "HH:MM:SS" format.

Elementos filhoChild Elements

ElementoElement DescriçãoDescription
<add> Adiciona um cache nomeado à coleção de namedCaches para um cache de memória.Adds a named cache to the namedCaches collection for a memory cache.
<clear> Limpa a coleção namedCaches de um cache de memória.Clears the namedCaches collection for a memory cache.
<remove> Remove uma entrada de cache nomeado da coleção de namedCaches para um cache de memória.Removes a named cache entry from the namedCaches collection for a memory cache.

Elementos paiParent Elements

ElementoElement DescriçãoDescription
<configuration> Especifica o elemento raiz em cada arquivo de configuração que é usado pelo Common Language Runtime e .NET Framework aplicativos.Specifies the root element in every configuration file that is used by the common language runtime and .NET Framework applications.
<memoryCache> Define um elemento usado para configurar um cache baseado na classe MemoryCache.Defines an element that is used to configure a cache that is based on the MemoryCache class.
<system.runtime.caching> Contém tipos que permitem implementar o cache de saída em aplicativos que são criados no .NET Framework.Contains types that let you implement output caching in applications that are built into the .NET Framework.

ComentáriosRemarks

A seção de configuração do cache de memória do arquivo Web.config pode conter add remove atributos, e clear para a namedCaches coleção.The memory cache configuration section of the Web.config file can contain add, remove, and clear attributes for the namedCaches collection. Cada namedCaches entrada é identificada exclusivamente pelo name atributo.Each namedCaches entry is uniquely identified by the name attribute.

Você pode recuperar instâncias de entradas de cache de memória referenciando as informações nos arquivos de configuração do aplicativo.You can retrieve instances of memory cache entries by referencing the information in the application configuration files. Por padrão, somente a instância de cache padrão tem uma entrada no arquivo de configuração.By default, only the default cache instance has an entry in the configuration file. A instância de cache padrão é a instância que é retornada da Default propriedade.The default cache instance is the instance that is returned from the Default property.

Se você definir o atributo Name como "default", o elemento usará a instância de cache de memória padrão.If you set the name attribute to "default", the element uses the default memory cache instance.

ExemploExample

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 "default".The following example shows how to set the name of the cache to the default cache entry name by setting the name attribute to "default".

O cacheMemoryLimitMegabytes atributo e o physicalMemoryPercentage atributo são definidos como zero.The cacheMemoryLimitMegabytes attribute and the physicalMemoryPercentage attribute are set to zero. Definir esses atributos como zero significa que a heurística de dimensionamento automático da MemoryCache classe é usada.Setting these attributes to zero means that the autosizing heuristics of the MemoryCache class are used. A implementação de cache compara a carga de memória atual com os limites de memória absolutos e baseados em porcentagem a cada dois minutos.The cache implementation compares the current memory load against the absolute and percentage-based memory limits every two minutes.

<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émSee also