Élément <requestCaching> (paramètres réseau)

  • Article

Contrôle le mécanisme de mise en cache pour les requêtes réseau.

<configuration>
  <system.net>
    <requestCaching>

Syntaxe

<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>

Attributs et éléments

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.

Attributs

Attribut Description
isPrivateCache Spécifie si le cache fournit une isolation entre les informations des différents utilisateurs. La valeur par défaut est true. Cette valeur doit être false destinée aux applications de couche intermédiaire.
disableAllCaching Spécifie que la mise en cache est désactivée pour toutes les réponses Web et ne peut pas être remplacée par programme.
defaultPolicyLevel Une des valeurs dans l'énumération RequestCacheLevel. La valeur par défaut est BypassCache.
unspecifiedMaximumAge Spécifie l’heure par défaut après laquelle le contenu est marqué comme expiré.

Attribut policyLevel

Valeur Description
Default Retourne la ressource mise en cache si la ressource est fraîche, la longueur du contenu est précise et les attributs d’expiration, de modification et de longueur de contenu sont présents.
BypassCache Retourne la ressource à partir du serveur.
CacheOnly Retourne la ressource mise en cache si la longueur du contenu est présente et correspond à la taille d’entrée.
CacheIfAvailable Retourne la ressource mise en cache si la longueur du contenu est fournie et correspond à la taille d’entrée ; sinon, la ressource est téléchargée à partir du serveur et est retournée à l’appelant.
Revalidate Renvoie la ressource mise en cache si l'horodatage de cette dernière est le même que celui de la ressource sur le serveur ; sinon, la ressource est téléchargée depuis le serveur, stockée dans le cache et renvoyée à l'appelant.
Reload Télécharge la ressource à partir du serveur, la stocke dans le cache et retourne la ressource à l’appelant.
NoCacheNoStore Si une ressource mise en cache existe, elle est supprimée. La ressource est téléchargée à partir du serveur et est retournée à l’appelant.
Revalidate Satisfait une demande en utilisant la copie mise en cache de la ressource si l'horodatage est le même que celui de la ressource sur le serveur ; sinon, la ressource est téléchargée à partir du serveur, présentée à l'appelant et stockée dans le cache.

Éléments enfants

Élément Description
defaultHttpCachePolicy Élément facultatif.

Décrit si la mise en cache HTTP est active et décrit la stratégie de mise en cache par défaut.
Élément <defaultFtpCachePolicy> (paramètres réseau) Élément facultatif.

Décrit si la mise en cache FTP est active et décrit la stratégie de mise en cache par défaut.

Éléments parents

Élément Description
system.net Contient des paramètres qui spécifient la manière dont .NET Framework se connecte au réseau.

Exemple

L’exemple suivant montre comment désactiver toutes les mises en cache.

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

Voir aussi