<Elemento requestCaching> (impostazioni di rete)

  • Articolo

Controlla il meccanismo di memorizzazione nella cache per le richieste di rete.

<Configurazione>
  <system.net>
    <requestCaching>

Sintassi

<requestCaching  
  isPrivateCache ="true|false"  
  disableAllCaching="true|false"  
  defaultPolicyLevel="BypassCache|Default|CacheOnly|CacheIfAvailable|Revalidate|Reload|NoCacheNoStore|Revalidate"  
  unspecifiedMaximumAge= "d.hh:mm:ss">  
    <defaultHttpCachePolicy>...</defaultHttpCachePolicy>  
    <defaultFtpCachePolicy>...</defaultFtpCachePolicy>  
</requestCaching>

Attributi ed elementi

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

Attributi

Attributo Descrizione
isPrivateCache Specifica se la cache fornisce l'isolamento tra le informazioni di utenti diversi. Il valore predefinito è true. Questo valore deve essere false per le applicazioni di livello intermedio.
disableAllCaching Specifica che la memorizzazione nella cache è disabilitata per tutte le risposte Web e non può essere sottoposta a override a livello di codice.
defaultPolicyLevel Uno dei valori dell'enumerazione RequestCacheLevel. Il valore predefinito è BypassCache.
unspecifiedMaximumAge Specifica l'ora predefinita dopo la quale il contenuto è contrassegnato come scaduto.

Attributo policyLevel

Valore Descrizione
Default Restituisce la risorsa memorizzata nella cache se la risorsa è aggiornata, la lunghezza del contenuto è accurata e sono presenti gli attributi di scadenza, modifica e lunghezza del contenuto.
BypassCache Restituisce la risorsa dal server.
CacheOnly Restituisce la risorsa memorizzata nella cache se la lunghezza del contenuto è presente e corrisponde alle dimensioni della voce.
CacheIfAvailable Restituisce la risorsa memorizzata nella cache se viene specificata la lunghezza del contenuto e corrisponde alla dimensione della voce; in caso contrario, la risorsa viene scaricata dal server e viene restituita al chiamante.
Revalidate Restituisce la risorsa memorizzata nella cache se il timestamp della risorsa memorizzata nella cache corrisponde al timestamp della risorsa nel server; in caso contrario, la risorsa viene scaricata dal server, archiviata nella cache e viene restituita al chiamante.
Reload Scarica la risorsa dal server, la archivia nella cache e restituisce la risorsa al chiamante.
NoCacheNoStore Se esiste una risorsa memorizzata nella cache, viene eliminata. La risorsa viene scaricata dal server e viene restituita al chiamante.
Revalidate Soddisfa una richiesta utilizzando la copia memorizzata nella cache della risorsa se il timestamp corrisponde al timestamp della risorsa nel server; in caso contrario, la risorsa viene scaricata dal server, presentata al chiamante e archiviata nella cache,

Elementi figlio

Elemento Descrizione
defaultHttpCachePolicy Elemento facoltativo.

Descrive se la memorizzazione nella cache HTTP è attiva e descrive i criteri di memorizzazione nella cache predefiniti.
<Elemento defaultFtpCachePolicy> (impostazioni di rete) Elemento facoltativo.

Descrive se la memorizzazione nella cache FTP è attiva e descrive i criteri di memorizzazione nella cache predefiniti.

Elementi padre

Elemento Descrizione
system.net Contiene le impostazioni di rete che specificano la modalità di connessione alla rete di .NET Framework.

Esempio

Nell'esempio seguente viene illustrato come disabilitare tutta la memorizzazione nella cache.

<configuration>  
  <system.net>  
    <requestCaching  
      disableAllCaching="true"  
    />  
  </system.net>  
</configuration>

Vedi anche