Classe RequestCachingSection
Contient des informations de configuration pour la mise en cache des requêtes.
Syntaxe
class RequestCachingSection : ConfigurationSection
Méthodes
Le tableau suivant répertorie les méthodes exposées par la classe RequestCachingSection.
| Nom | Description |
|---|---|
| GetAllowDefinition | (Hérité de ConfigurationSection.) |
| GetAllowLocation | (Hérité de ConfigurationSection.) |
| RevertToParent | (Hérité de ConfigurationSection.) |
| SetAllowDefinition | (Hérité de ConfigurationSection.) |
| SetAllowLocation | (Hérité de ConfigurationSection.) |
Propriétés
Le tableau suivant répertorie les propriétés exposées par la classe RequestCachingSection.
| Nom | Description |
|---|---|
DefaultFtpCachePolicy |
Valeur FtpCachePolicySettings qui spécifie le comportement par défaut de la mise en cache FTP pour l'ordinateur local. |
DefaultHttpCachePolicy |
Valeur HttpCachePolicySettings qui spécifie le comportement par défaut de la mise en cache HTTP pour l'ordinateur local. |
DefaultPolicyLevel |
Valeur sint32 de lecture/écriture qui spécifie le niveau de stratégie de cache par défaut. Les valeurs possibles sont répertoriées plus loin dans la section Remarques. |
DisableAllCaching |
Une valeur boolean de lecture/écriture. true si la mise en cache est désactivée sur l'ordinateur local. Sinon false. Remarque : si cet attribut de configuration est défini surtrue sur n'importe quel fichier de configuration, la mise en cache est désactivée globalement et tous les autres paramètres liés au cache sont ignorés. |
IsPrivateCache |
Une valeur boolean de lecture/écriture. true si le cache de l'ordinateur local est privé (autrement dit, fournit une isolation utilisateur). Sinon false. Remarque : sur les ordinateurs clients, cette valeur est généralement définie sur true, ce qui indique qu'un utilisateur ne peut pas utiliser les ressources mises en cache par un autre utilisateur. Pour les applications de niveau intermédiaire, cette valeur est généralement définie sur false. |
Location |
(Hérité de ConfigurationSection.) Une propriété clé. |
Path |
(Hérité de ConfigurationSection.) Une propriété clé. |
SectionInformation |
(Hérité de ConfigurationSection.) |
UnspecifiedMaximumAge |
Valeur datetime de lecture/écriture qui spécifie l'âge maximum par défaut des ressources mises en cache qui ne disposent pas d'informations d'expiration. La valeur par défaut est 1 jour. La définition de cette propriété garantit qu'une ressource qui n'a pas d'informations d'en-tête d'expiration ne reste pas indéfiniment actualisée dans le cache. |
Sous-classes
Cette classe ne contient aucune sous-classe.
Notes
Le tableau suivant répertorie les valeurs possibles pour la propriété DefaultPolicyLevel. La valeur par défaut est 1 (BypassCache).
| Valeur | Mot clé | Description |
|---|---|---|
| 0 | Default |
Satisfait une requête d'une ressource à l'aide de la copie mise en cache de la ressource ou en envoyant une requête de la ressource au serveur. L'action effectuée est déterminée par la stratégie de cache actuelle et l'âge du contenu dans le cache. La plupart des applications doivent utiliser ce niveau de cache. |
| 1 | BypassCache |
Satisfait une requête à l'aide du serveur. Aucune entrée n'est extraite des caches, ajoutées aux caches ou supprimées des caches entre le client et le serveur. Il s'agit du comportement de cache par défaut spécifié dans le fichier de configuration de l'ordinateur inclus dans le .NET Framework. |
| 2 | CacheOnly |
Satisfait une requête à l'aide de la ressource mise en cache localement ; n'envoie pas de requête d'élément qui n'est pas dans le cache. Lorsque ce niveau de stratégie de cache est spécifié, une exception WebException est levée si l'élément ne se trouve pas dans le cache client. |
| 3 | CacheIfAvailable |
Satisfait une requête de ressource à partir du cache si la ressource est disponible. Sinon envoie une requête de ressource au serveur. Si l'élément demandé n'est pas disponible dans le cache local, mais qu'il l'est dans un cache intermédiaire entre le client et le serveur, le cache intermédiaire répond à la requête. |
| 4 | Revalidate |
Satisfait une requête 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 enregistrée dans le cache. |
| 5 | Reload |
Satisfait une requête à l'aide du serveur. La réponse peut être enregistrée dans le cache, en fonction des paramètres de la no-cache directive de contrôle du cache et de l'en-tête Pragma: no-cache dans le protocole de mise en cache HTTP. |
| 6 | NoCacheNoStore |
Ne répond jamais à une requête à l'aide de ressources du cache et ne met pas en cache les ressources. Si la ressource est présente dans le cache local, elle en est supprimée. Ce niveau de stratégie indique aux caches intermédiaires qu'ils doivent supprimer la ressource. Dans le protocole de mise en cache HTTP, vous pouvez accomplir cette tâche à l'aide de la no-cache directive de contrôle de cache. |
Hiérarchie d'héritage
RequestCachingSection
Spécifications
| Type | Description |
|---|---|
| Client | - IIS 7.0 sous Windows Vista - IIS 7.5 sur Windows 7 - IIS 8.0 sous Windows 8 - IIS 10.0 sur Windows 10 |
| Serveur | - IIS 7.0 sous Windows Server 2008 - IIS 7.5 sous Windows Server 2008 R2 - IIS 8.0 sur Windows Server 2012 - IIS 8.5 sur Windows Server 2012 R2 - IIS 10.0 sur Windows Server 2016 |
| Produit | - IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0 |
| Fichier MOF | WebAdministration.mof |
Voir aussi
Classe ConfigurationSection
Classe FtpCachePolicySettings
Classe HttpCachePolicySettings
Énumération System.Net.Cache.RequestCacheLevel
Classe System.Net.WebException
CIM_DATETIME