<memoryCache> elemento (impostazioni della Cache)<memoryCache> Element (Cache Settings)

Definisce un elemento che viene usato per configurare una cache basata sulla classe MemoryCache .Defines an element that is used to configure a cache that is based on the MemoryCache class. La classe MemoryCacheElement definisce un elemento memoryCache che è possibile usare per configurare la cache.The MemoryCacheElement class defines a memoryCache element that you can use to configure the cache. In una singola applicazione possono essere usate più istanze della classe MemoryCache .Multiple instances of the MemoryCache class can be used in a single application. Ogni elemento memoryCache nel file di configurazione può contenere le impostazioni per un'istanza denominata di MemoryCache .Each memoryCache element in the configuration file can contain settings for a named MemoryCache instance.

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

SintassiSyntax

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

TipoType

ClasseMemoryCache .MemoryCache class.

Attributi ed elementiAttributes and Elements

Nelle sezioni seguenti vengono descritti gli attributi, gli elementi figlio e gli elementi padre.The following sections describe attributes, child elements, and parent elements.

AttributiAttributes

AttributoAttribute DescrizioneDescription
CacheMemoryLimitMegabytes La dimensione massima di memoria, in megabyte, che un'istanza di un oggetto MemoryCache può raggiungere.The maximum memory size, in megabytes, that an instance of a MemoryCache object can grow to. Il valore predefinito è 0 e significa che vengono usate per impostazione predefinita le euristiche di dimensionamento automatico della classe MemoryCache.The default value is 0, which means that the MemoryCache class's autosize heuristics are used by default.
Name Nome della configurazione della cache.The name of the cache configuration.
PhysicalMemoryLimitPercentage Percentuale di memoria fisica utilizzabile dalla cache.The percentage of physical memory that can be used by the cache. Il valore predefinito è 0 e significa che vengono usate per impostazione predefinita le euristiche di dimensionamento automatico della classe MemoryCache .The default value is 0, which means that the MemoryCache class's autosize heuristics are used by default.
PollingInterval Un valore che indica l'intervallo di tempo dopo il quale l'implementazione della cache confronta il carico di memoria corrente con i limiti di memoria percentuali e assoluti impostati per l'istanza della 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. Il valore viene inserito nel formato "HH:MM:SS".The value is entered in "HH:MM:SS" format.

Elementi figlioChild Elements

ElementoElement DescrizioneDescription
<namedCaches><namedCaches> Contiene una raccolta di impostazioni di configurazione per l'istanza namedCache .Contains a collection of configuration settings for the namedCache instance.

Elementi padreParent Elements

ElementoElement DescrizioneDescription
<system.runtime.caching><system.runtime.caching> Contiene tipi che consentono di implementare la memorizzazione nella cache di output nelle applicazioni integrate in .NET Framework.NET Framework.Contains types that let you implement output caching in applications that are built into the .NET Framework.NET Framework.

NoteRemarks

La classe MemoryCache è un'implementazione concreta della classe astratta ObjectCache .The MemoryCache class is a concrete implementation of the abstract ObjectCache class. Alle istanze della classe MemoryCache possono essere fornite le informazioni di configurazione dei file di configurazione dell'applicazione.Instances of the MemoryCache class can be supplied with configuration information from application configuration files. La sezione memoryCache della configurazione contiene una raccolta di configurazioni namedCaches .The memoryCache configuration section contains a namedCaches configuration collection.

Quando viene inizializzato un oggetto cache basato sulla memoria, esso tenta innanzitutto di trovare una voce namedCaches che corrisponde al nome nel parametro che viene passato al costruttore della cache in memoria.When a memory-based cache object is initialized, it first tries to find a namedCaches entry that matches the name in the parameter that is passed to the memory cache constructor. Se viene trovata una voce namedCaches , le informazioni di polling e di gestione della memoria vengono recuperate dal file di configurazione.If a namedCaches entry is found, the polling and memory-management information are retrieved from the configuration file.

Il processo di inizializzazione determina quindi se è stato eseguito l'override di qualche voce di configurazione usando la raccolta facoltativa di coppie nome-valore delle informazioni di configurazione nel costruttore.The initialization process then determines whether any configuration entries were overridden, by using the optional collection of name/value pairs of configuration information in the constructor. Se viene passato uno qualsiasi dei seguenti valori nella raccolta di coppie nome-valore, questi valori eseguono l'override delle informazioni ottenute dal file di configurazione:If you pass any one of the following values in the name/value pair collection, these values override information obtained from the configuration file:

EsempioExample

L'esempio seguente illustra come impostare il nome dell'oggetto MemoryCache sul nome dell'oggetto cache predefinito impostando l'attributo name "default".The following example shows how to set the name of the MemoryCache object to the default cache object name by setting the name attribute to "default".

Gli attributi cacheMemoryLimitMegabytes e physicalMemoryLimitPercentage sono impostati su zero.The cacheMemoryLimitMegabytes attribute and the physicalMemoryLimitPercentage attribute are set to zero. Il valore zero di questi attributi indica che per impostazione predefinita vengono usate le euristiche di ridimensionamento automatico di MemoryCache .Setting these attributes to zero means that the MemoryCache autosizing heuristics are used by default. L'implementazione della cache deve confrontare ogni due minuti il carico di memoria corrente con i limiti di memoria assoluti e in percentuale.The cache implementation should compare 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>  

Vedere ancheSee Also

MemoryCache
<Caching > elemento (impostazioni della Cache)<system.runtime.caching> Element (Cache Settings)
<namedCaches > Element (Cache Settings)<namedCaches> Element (Cache Settings)