Elemento <namedCaches> (impostazioni cache)

Specifica un insieme di impostazioni di configurazione delle istanze di MemoryCache denominate. La proprietà NamedCaches fa riferimento all'insieme di impostazioni di configurazione da uno o più elementi namedCaches del file di configurazione.

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

None

Attributi ed elementi

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

Attributi

Attribute	Oggetto di descrizione
CacheMemoryLimitMegabytes	Valore intero che specifica la dimensione massima consentita, 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 cache.
PhysicalMemoryLimitPercentage	Un valore intero tra 0 e 100 specifica la percentuale massima di memoria del computer fisicamente installata 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
<add>	Aggiunge una cache denominata alla raccolta namedCaches per una cache di memoria.
<clear>	Cancella la raccolta namedCaches per una cache in memoria.
<remove>	Rimuove una cache denominata dalla raccolta namedCaches per una cache in memoria.

Elementi padre

Elemento	Oggetto di descrizione
<memoryCache>	Definisce un elemento utilizzato per configurare una cache basata sulla classe MemoryCache.

Note

La sezione di configurazione della cache in memoria del file Web.config può contenere attributi add, remove e clear per l'insieme namedCaches. La voce namedCaches viene identificata in modo univoco dall'attributo name.

È possibile recuperare istanze di voci della cache in memoria facendo riferimento alle informazioni nei file di configurazione dell'applicazione. Per impostazione predefinita, solo l'istanza della cache predefinita dispone di una voce nel file di configurazione. L'istanza della cache predefinita è l'istanza restituita dalla proprietà Default.

Se si imposta l'attributo del nome in "predefinito", l'elemento utilizza l'istanza della cache in memoria predefinita.

Esempio

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

L'attributo cacheMemoryLimitMegabytes e l'attributo physicalMemoryPercentage sono impostati su zero. Impostando questi attributi su zero, vengono utilizzate le regole euristiche di dimensionamento automatico della classe MemoryCache. L'implementazione della cache confronta 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 <memoryCache> (impostazioni cache)

Last updated on 2011-08-11