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

Article
05/10/2023

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>

Partager via