<Elemento requestCaching> (impostazioni di rete)

Articolo
04/08/2023

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>

Condividi tramite