Elemento <memoryCache> (impostazioni cache)

Definisce un elemento utilizzato per configurare una cache basata sulla classe MemoryCache. La classe MemoryCacheElement definisce un elemento memoryCache che si può utilizzare per configurare la cache. È possibile utilizzare istanze multiple della classe MemoryCache in una singola applicazione. Ogni elemento memoryCache nel file di configurazione può contenere impostazioni di configurazione per un'stanza MemoryCache denominata.

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

Classe MemoryCache.

Attributi ed elementi

Nelle sezioni seguenti vengono illustrati attributi, elementi figlio e padre.

Attributi

Attribute

Oggetto di descrizione

CacheMemoryLimitMegabytes

La dimensione massima della memoria, in megabyte, che un'istanza di un oggetto MemoryCache può raggiungere. Il valore predefinito è 0, il che indica che le euristiche di dimensionamento automatico della classe MemoryCache sono utilizzate per impostazione predefinita.

Name

Nome della configurazione della cache.

PhysicalMemoryLimitPercentage

La percentuale di memoria fisica che può essere utilizzata dalla cache. Il valore predefinito è 0, il che indica che le euristiche di dimensionamento automatico della classe MemoryCache sono utilizzate per impostazione predefinita.

PollingInterval

Un valore che indica l'intervallo di tempo, trascorso il quale l'implementazione della cache confronta il carico di memoria corrente a fronte dei limiti di memoria in percentuale e assoluti impostati per l'istanza della cache. Il valore viene immesso in formato "hh:mm:ss."

Elementi figlio

Elemento

Oggetto di descrizione

<namedCaches>

Contiene una raccolta di impostazioni di configurazione per le istanze di namedCache.

Elementi padre

Elemento

Oggetto di descrizione

<system.runtime.caching>

Contiene tipi che consentono di implementare la memorizzazione dell'output nella cache nelle applicazioni compilate in .NET Framework.

Note

La classe MemoryCache è un'implementazione concreta della classe astratta ObjectCache. Istanze della classe MemoryCache possono essere fornite con le informazioni di configurazione dai file di configurazione dell'applicazione. La sezione di configurazione memoryCache contiene un insieme di configurazione namedCaches

Quando viene inizializzato un oggetto cache basato sulla memoria, esso tenta prima di trovare la voce namedCaches che corrisponde al nome nel parametro passato al costruttore della cache in memoria. Se la voce namedCaches viene trovata, la modalità di polling e le informazioni sulla gestione della memoria vengono recuperate dal file di configurazione.

Il processo di inizializzazione determina quindi se l'override di qualsiasi voce di configurazione è eseguito, utilizzando l'insieme facoltativo di coppie nome/valore di informazioni di configurazione nel costruttore. Se viene passato uno dei valori seguenti nell'insieme della coppia nome/valore, questi valori eseguono l'override di informazioni ottenute dal file di configurazione:

Esempio

Nell'esempio seguente viene illustrato come impostare il nome della cache nel nome dell'oggetto MemoryCache nel nome dell'oggetto della cache predefinita impostando l'attributo name su "valore predefinito".

L'attributo cacheMemoryLimitMegabytes e l'attributo physicalMemoryPercentage sono impostati su zero. Impostando questi attributi a zero, le regole euristiche di dimensionamento automatico MemoryCache sono utilizzate come predefinite. L'implementazione della cache deve confrontare il carico di memoria corrente ai limiti di memoria in percentuale e assoluti ogni due minuti.

<configuration>
  <system.runtime.caching>
    <memoryCache>
      <namedCaches>
          <add name="default" 
               cacheMemoryLimitMegabytes="0" 
               physicalMemoryPercentage="0"
               pollingInterval="00:02:00" />
      </namedCaches>
    </memoryCache>
  </system.runtime.caching>
</configuration>

Vedere anche

Riferimenti

Elemento <system.runtime.caching> (impostazioni cache)

Elemento <namedCaches> (impostazioni cache)

MemoryCache