<Elemento namedCaches> (impostazioni cache)

Articolo
05/09/2023

Specifica una raccolta di impostazioni di configurazione per le istanze denominate MemoryCache . La NamedCaches proprietà fa riferimento alla raccolta di impostazioni di configurazione da uno o più namedCaches elementi del file di configurazione.

<Configurazione>
  <System.runtime.caching>
    <Memorycache>
      <Namedcaches>

Sintassi

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

Tipo

None

Attributi ed elementi

Nelle sezioni seguenti vengono descritti gli attributi, gli elementi figlio e gli elementi padre.

Attributi

Attributo	Descrizione
`cacheMemoryLimitMegabytes`	Valore intero che specifica le dimensioni massime consentite, in megabyte, in cui un'istanza di un MemoryCache oggetto può aumentare. Il valore predefinito è 0, ovvero l'euristica automatica della MemoryCache classe viene usata per impostazione predefinita.
`name`	Nome della cache.
`physicalMemoryLimitPercentage`	Valore intero compreso tra 0 e 100 che specifica la percentuale massima di memoria computer installata fisicamente che può essere utilizzata dalla cache. Il valore predefinito è 0, ovvero l'euristica automatica della MemoryCache classe viene usata per impostazione predefinita.
`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. Questo valore viene immesso nel formato "HH:MM:SS".

Elementi figlio

Elemento	Descrizione
<add>	Aggiunge una cache denominata alla raccolta `namedCaches` per una cache in memoria.
<Chiaro>	Cancella la raccolta `namedCaches` per una cache in memoria.
<Rimuovere>	Rimuove una cache denominata dalla raccolta `namedCaches` per una cache in memoria.

Elementi padre

Elemento	Descrizione
<Configurazione>	Specifica l'elemento radice in ogni file di configurazione usato dalle applicazioni Common Language Runtime e .NET Framework.
<Memorycache>	Definisce un elemento che viene usato per configurare una cache basata sulla classe MemoryCache .
<System.runtime.caching>	Contiene tipi che consentono di implementare la memorizzazione nella cache di output nelle applicazioni integrate in .NET Framework.

Commenti

La sezione di configurazione della cache di memoria del file Web.config può contenere addattributi , removee clear per la namedCaches raccolta. Ogni namedCaches voce è identificata in modo univoco dall'attributo name .

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

Se si imposta l'attributo name su "Default", l'elemento usa l'istanza predefinita della cache della memoria.

Esempio

Nell'esempio seguente viene illustrato come impostare il nome della cache sul nome predefinito della voce della cache impostando l'attributo name su "Default".

Gli attributi cacheMemoryLimitMegabytes e physicalMemoryPercentage sono impostati su zero. L'impostazione di questi attributi su zero indica che vengono usate le euristiche automatiche della MemoryCache classe . L'implementazione della cache confronta il carico di memoria corrente con i limiti di memoria assoluti e basati su percentuale ogni due minuti.

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