Elemento cache per caching (schema delle impostazioni ASP.NET)

Aggiornamento: novembre 2007

Definisce le impostazioni della cache a livello di applicazione per un'applicazione Web ASP.NET.

Elemento configuration (schema delle impostazioni generali)
  Elemento system.web (schema delle impostazioni ASP.NET)
    Elemento caching (schema delle impostazioni ASP.NET)
      Elemento cache per caching (schema delle impostazioni ASP.NET)

<cache disableMemoryCollection="true|false" 
       disableExpiration="true|false" 
       privateBytesLimit="number" 
       percentagePhysicalMemoryUsedLimit="number" 
       privateBytesPollTime="HH:MM:SS" />

Attributi ed elementi

Nelle sezioni riportate di seguito vengono illustrati attributi, elementi figlio ed elementi padre.

Attributi

Attributo

Descrizione

disableMemoryCollection

Attributo Boolean facoltativo.

Ottiene o imposta un valore indicante se la raccolta della memoria cache che si verifica quando il computer è in una condizione di pressione della memoria è disattivata.

disableExpiration

Attributo Boolean facoltativo.

Ottiene o imposta un valore che indica se la scadenza della cache è disattivata. Se disattivato, gli elementi memorizzati nella cache non scadono e non si verifica lo scavenging in background degli elementi della cache scaduti.

privateBytesLimit

Attributo Int64 facoltativo.

Ottiene o imposta un valore indicante la dimensione massima della memoria in byte privati di un'applicazione prima che la cache inizi la rimozione degli elementi scaduti e il tentativo di recuperare memoria. Questo limite include sia la memoria utilizzata dalla cache sia il normale sovraccarico di memoria dell'applicazione in esecuzione. L'impostazione zero indica che verranno utilizzate le regole euristiche di ASP.NET per determinare quando iniziare il recupero della memoria.

percentagePhysicalMemoryUsedLimit

Attributo Int32 facoltativo.

Ottiene o imposta un valore che indica la percentuale massima della memoria fisica di un computer che può essere utilizzata prima che la cache inizi la rimozione degli elementi e tenti di recuperare memoria. Il limite viene applicato alla memoria fisica totale utilizzata. Un'impostazione di 0 comporta la rimozione immediata delle voci inserite.

privateBytesPollTime

Attributo TimeSpan facoltativo.

Ottiene o imposta un valore indicante l'intervallo di tempo che deve trascorrere tra i polling dell'utilizzo della memoria in byte privati dell'applicazione.

Elementi figlio

Nessuno.

Elementi padre

Elemento

Descrizione

configuration

È l'elemento di primo livello necessario in ciascun file di configurazione utilizzato in Common Language Runtime e nelle applicazioni .NET Framework.

system.web

Specifica l'elemento di primo livello per le impostazioni di configurazione ASP.NET in un file di configurazione. Contiene gli elementi per la configurazione di applicazioni Web ASP.NET e il controllo del comportamento delle stesse.

caching

Configura le impostazioni della cache per un'applicazione Web.

Note

Configurazione predefinita

Il seguente elemento cache predefinito non viene configurato in modo esplicito nel file di configurazione del computer o nel file Web.config a livello di radice, ma è la configurazione predefinita restituita da un'applicazione in .NET Framework versione 2.0.

<cache disableMemoryCollection="false" 
  disableExpiration="false" privateBytesLimit="0" 
  percentagePhysicalMemoryUsedLimit="90" 
  privateBytesPollTime="00:02:00" />

Esempio

Nell'esempio riportato di seguito vengono impostate le impostazioni globali della cache per un'applicazione ASP.NET.

<cache disableMemoryCollection = "false" 
  disableExpiration = "false" 
  privateBytesLimit = "20971520" 
  percentagePhysicalMemoryUsedLimit = 60" 
  privateBytesPollTime = "00:01:00"/>

Informazioni sull'elemento

Gestore della sezione di configurazione

System.Web.Configuration.CacheSection

Membro di configurazione

Cache

Percorsi configurabili

Machine.config

Web.config a livello di radice

Web.config a livello di applicazione

Requisiti

IIS versione 5.0, 5.1 e 6.0

.NET Framework versione 2.0

Visual Studio 2005

Vedere anche

Attività

Procedura: configurare directory specifiche utilizzando le impostazioni posizione

Procedura: bloccare le impostazioni di configurazione di ASP.NET

Concetti

Configurazione della cache in ASP.NET

Cenni preliminari sull'inserimento nella cache in ASP.NET

Gerarchia ed ereditarietà dei file di configurazione di ASP.NET

Protezione della configurazione di ASP.NET

Scenari di configurazione ASP.NET

Riferimenti

Elemento system.web (schema delle impostazioni ASP.NET)

Elemento configuration (schema delle impostazioni generali)

Elemento cache per caching (schema delle impostazioni ASP.NET)

System.Configuration

System.Web.Configuration

Altre risorse

Impostazioni di configurazione generali (ASP.NET)

Impostazioni di configurazione di ASP.NET

Amministrazione di siti Web ASP.NET

File di configurazione ASP.NET

API di configurazione di ASP.NET