<defaultHttpCachePolicy>, élément (paramètres réseau)

Article
08/10/2011

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

< defaultHttpCachePolicy
  policyLevel="BypassCache|Default"
  minimumFresh="d.hh:mm:ss"|"minValue"
  maximumAge  ="d.hh:mm:ss"|"maxValue"
  maximumStale="d.hh:mm:ss"|"maxValue"
/>

Attributs et éléments

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

Attributs

Attribut	Description
maximumAge	Spécifie l'intervalle de temps maximal avant qu'un objet mis en cache soit marqué comme expiré.
maximumStale	Spécifie le délai maximal devant s'écouler après l'heure de nouveauté calculée, avant qu'un objet mis en cache soit marqué comme expiré.
minimumFresh	Spécifie le délai minimum pour qu'un objet mis en cache soit considéré comme nouveau.
policyLevel	Spécifie si la stratégie de mise en cache est automatique, ou si le cache est ignoré. La valeur par défaut est BypassCache.

Éléments enfants

Aucun

Éléments parents

Élément	Description
<requestCaching>	Contrôle le mécanisme de mise en cache pour les demandes réseau.

Notes

L'élément <defaultHttpCachePolicy> indique si la mise en cache HTTP est active et décrit la stratégie de mise en cache par défaut. Il s'agit d'un élément facultatif.

La valeur de l'attribut policyLevel est BypassCache ou Default.

Les valeurs pour les éléments maximumAge, maximumStale et minimumFresh correspondent soit à un intervalle de temps explicite au format d.hh:mm:ss (jours, heures, minutes et secondes) soit aux constantes minValue ou maxValue, selon le cas.

Fichiers de configuration

Cet élément peut être utilisé dans le fichier de configuration de l'application ou dans le fichier de configuration machine (Machine.config).

Exemple

L'exemple de code suivant indique comment spécifier un délai de nouveauté minimum de six heures, un âge maximal de deux jours, et un délai de péremption maximal de quatre heures.

<configuration>
  <system.net>
    <requestCaching>
      <defaultHttpCachePolicy>
        <set minimumFresh="0.06:00:00" />
        <set maximumAge  ="2.00:00:00" />
        <set maximumStale="0.04:00:00" />
      </defaultHttpCachePolicy>
    </requestCaching>
  </system.net>
</configuration>