Classe OutputCacheProfile
Configure le profil de cache de sortie pour les pages d'une application internet.
Syntaxe
class OutputCacheProfile : CollectionElement
Méthodes
Cette classe ne contient pas de méthodes.
Propriétés
Le tableau suivant répertorie les propriétés exposées par la classe OutputCacheProfile.
| Nom | Description |
|---|---|
Duration |
Valeur sint32 de lecture/écriture qui spécifie la durée, en secondes, pendant laquelle la page ou le contrôle utilisateur est mis en cache. La valeur par défaut est –1. La définition de cet attribut sur une page ou un contrôle utilisateur établit une politique d'expiration pour les réponses HTTP de la page ou du contrôle utilisateur et met automatiquement en cache la sortie de la page ou du contrôle utilisateur. Remarque : cette propriété doit être définie soit dans le profil, soit dans la directive @ OutputCache d'une page qui utilise le profil. |
Enabled |
Une valeur boolean de lecture/écriture. true si la mise en cache est activée pour toutes les pages ou contrôles qui utilisent ce profil de cache de sortie. Sinon false. Par défaut, il s’agit de true. |
Location |
Valeur sint32 de lecture/écriture qui spécifie l'emplacement du cache. Les valeurs possibles sont répertoriées plus loin dans la section Remarques. |
Name |
Valeur string de lecture seule qui spécifie le nom du profil de cache de sortie. |
NoStore |
Une valeur boolean de lecture/écriture. true si la page émet un en-tête Cache-Control: Private no-store dans la réponse HTTP qui indique au navigateur de ne pas mettre la page en cache. Sinon false. Par défaut, il s’agit de false. Remarque : la définition de cet attribut true équivaut à appeler la méthode System.Web.HttpCachePolicy.SetNoStore pendant une requête Web. |
SqlDependency |
Valeur string de lecture/écriture qui identifie un ensemble de paires de noms de tables et de bases de données SQL dont dépend le cache de sortie d'une page ou d'un contrôle. Lorsque vous spécifiez une chaîne pour cette propriété, les pages mises en cache en sortie peuvent être supprimées du cache lorsque le tableau SQL dont elles dépendent est modifié. |
VaryByControl |
Valeur string de lecture/écriture qui spécifie un ensemble d'ID de contrôles à mettre en cache, délimité par des virgules. Remarque : les paramètres de cette propriété sont identiques à ceux de l'attribut VaryByControls de la directive @ OutputCache. |
VaryByCustom |
Valeur string de lecture/écriture, délimitée par des virgules, qui représente les exigences personnalisées en matière de mise en cache des données de sortie. Si vous attribuez à cette propriété la valeur « navigateur », le cache varie en fonction du nom du navigateur et des informations sur la version majeure. Si vous saisissez une chaîne personnalisée, vous devez remplacer la méthode GetVaryByCustomString dans le fichier Global.asax de votre application. Remarque : les paramètres de cette propriété sont identiques à ceux de l'attribut VaryByCustom de la directive @ OutputCache. |
VaryByHeader |
Une valeur string de lecture/écriture qui spécifie un ensemble d'en-têtes HTTP, délimités par des virgules, qui sont associés à la requête et sont utilisés pour varier la sortie en cache. Remarque : les paramètres de cette propriété sont identiques à ceux de l'attribut VaryByHeader de la directive @ OutputCache. |
VaryByParam |
Valeur string qui spécifie un ensemble délimité par des virgules de paramètres qui varient la sortie mise en cache par la chaîne de requête GET ou les paramètres POST de formulaire. Remarque : les paramètres de cette propriété sont identiques à ceux de l'attribut VaryByParam de la directive @ OutputCache. |
Sous-classes
Cette classe ne contient aucune sous-classe.
Notes
Les instances de cette classe sont contenues dans la propriété de tableau OutputCacheProfiles de la classe OutputCacheProfileSettings.
Le tableau suivant répertorie les valeurs possibles pour la propriété Location.
| Valeur | Mot clé | Description |
|---|---|---|
| 0 | Any |
La page est mise en cache sur le serveur, tous les proxys compatibles HTTP 1.1 et le client. Cette valeur correspond à la valeur d'énumération System.Web.HttpCacheability.Public. |
| 1 | Client |
La page est mise en cache uniquement sur le client à l'origine de la requête. Cette valeur correspond à la valeur d'énumération System.Web.HttpCacheability.Private. |
| 2 | Downstream |
La page est mise en cache sur tous les appareils compatibles avec le cache HTTP 1.1, à l'exception du serveur d'origine. Les dispositifs compatibles avec le cache comprennent les serveurs proxy et le client qui a formulé la requête. |
| 3 | Server |
La page est mise en cache uniquement sur le serveur web où la requête a été traitée. Cette valeur correspond à la valeur d'énumération System.Web.HttpCacheability.Server. |
| 4 | None |
La page n'est pas mise en cache. Cette valeur correspond à la valeur d'énumération System.Web.HttpCacheability.NoCache. |
| 5 | ServerAndClient |
La page est mise en cache uniquement sur le serveur d'origine ou sur le client requêteur. Les serveurs proxy ne sont pas autorisés à mettre la réponse en cache. Cette valeur correspond à la combinaison des valeurs d'énumération System.Web.HttpCacheability.Private et System.Web.HttpCacheability.Server. |
Hiérarchie d'héritage
OutputCacheProfile
Spécifications
| Type | Description |
|---|---|
| Client | - IIS 7.0 sur 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
System.Web.HttpCachePolicy.SetNoStoreSystem.Web.HttpCacheabilitySystem.Web.UI.OutputCacheLocation
Classe CollectionElement
Classe OutputCacheSection
Classe OutputCacheSettingsSection
Classe OutputCacheProfileSettings
Classe SqlCacheDependencySection
@ OutputCache
Mise en cache de plusieurs versions de la sortie du contrôle utilisateur