<requestCaching>, élément (paramètres réseau)<requestCaching> Element (Network Settings)

Contrôle le mécanisme de mise en cache pour les demandes réseau.Controls the caching mechanism for network requests.

<configuration> <configuration>
   <System. net >   <system.net>
     <requestCaching >    <requestCaching>

SyntaxeSyntax

<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émentsAttributes and Elements

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.The following sections describe attributes, child elements, and parent elements.

AttributsAttributes

AttributAttribute DescriptionDescription
isPrivateCache Spécifie si le cache assure l’isolement entre les informations des différents utilisateurs.Specifies whether the cache provides isolation between the information of different users. La valeur par défaut est true.The default value is true. Cette valeur doit être false pour les applications de niveau intermédiaire.This value should be false for middle tier applications.
disableAllCaching Spécifie que la mise en cache est désactivée pour toutes les réponses Web et ne peut pas être substituée par programmation.Specifies that caching is disabled for all Web responses, and cannot be overridden programmatically.
defaultPolicyLevel Une des valeurs dans l'énumération RequestCacheLevel.One of the values in the RequestCacheLevel enumeration. La valeur par défaut est BypassCache.The default value is BypassCache.
unspecifiedMaximumAge Spécifie l’heure par défaut après laquelle le contenu est marqué comme ayant expiré.Specifies the default time after which content is marked as expired.

policyLevel (attribut)policyLevel Attribute

ValueValue DescriptionDescription
Default Retourne la ressource mise en cache si la ressource est actualisée, si la longueur du contenu est exacte et si les attributs d’expiration, de modification et de longueur du contenu sont présents.Returns the cached resource if the resource is fresh, the content length is accurate, and the expiration, modification, and content length attributes are present.
BypassCache Retourne la ressource à partir du serveur.Returns the resource from the server.
CacheOnly Retourne la ressource mise en cache si la longueur du contenu est présente et correspond à la taille de l’entrée.Returns the cached resource if the content length is present and matches the entry size.
CacheIfAvailable Retourne la ressource mise en cache si la longueur du contenu est fournie et correspond à la taille de l’entrée ; dans le cas contraire, la ressource est téléchargée à partir du serveur et est retournée à l’appelant.Returns the cached resource if the content length is provided and matches the entry size; otherwise, the resource is downloaded from the server and is returned to the caller.
Revalidate Retourne la ressource mise en cache si l’horodateur de la ressource mise en cache est le même que celui de la ressource sur le serveur ; dans le cas contraire, la ressource est téléchargée à partir du serveur, stockée dans le cache, et est retournée à l’appelant.Returns the cached resource if the timestamp of the cached resource is the same as the timestamp of the resource on the server; otherwise, the resource is downloaded from the server, stored in the cache, and is returned to the caller.
Reload Télécharge la ressource à partir du serveur, la stocke dans le cache et retourne la ressource à l’appelant.Downloads the resource from the server, stores it in the cache, and returns the resource to the caller.
NoCacheNoStore Si une ressource mise en cache existe, elle est supprimée.If a cached resource exists, it is deleted. La ressource est téléchargée à partir du serveur et est retournée à l’appelant.The resource is downloaded from the server and is returned to the caller.
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 ; dans le cas contraire, la ressource est téléchargée à partir du serveur, présentée à l’appelant et stockée dans le cache.Satisfies a request by using the cached copy of the resource if the timestamp is the same as the timestamp of the resource on the server; otherwise, the resource is downloaded from the server, presented to the caller, and is stored in the cache,

Éléments enfantsChild Elements

ÉlémentElement DescriptionDescription
defaultHttpCachePolicydefaultHttpCachePolicy Élément facultatif.Optional element.

Indique si la mise en cache HTTP est active et décrit la stratégie de mise en cache par défaut.Describes whether HTTP caching is active and describes the default caching policy.
<defaultFtpCachePolicy >, élément (paramètres réseau)<defaultFtpCachePolicy> Element (Network Settings) Élément facultatif.Optional element.

Indique si la mise en cache FTP est active et décrit la stratégie de mise en cache par défaut.Describes whether FTP caching is active and describes the default caching policy.

Éléments parentsParent Elements

ÉlémentElement DescriptionDescription
system.netsystem.net Contient des paramètres qui spécifient la manière dont .NET Framework se connecte au réseau.Contains settings that specify how the .NET Framework connects to the network.

ExempleExample

L’exemple suivant montre comment désactiver toute la mise en cache.The following example shows how to disable all caching.

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

Voir aussiSee also