add, élément de outputCacheProfiles pour caching (Schéma des paramètres ASP.NET)

Article
09/04/2008

Mise à jour : novembre 2007

Ajoute un objet OutputCacheProfile à la collection de configurations. Les profils de cache peuvent être référencés uniquement à partir de la directive @ OutputCache des pages. Les profils ne sont pas pris en charge sur les contrôles utilisateur ou sur les contrôles serveur.

configuration, élément (Schéma des paramètres généraux)
  system.web, élément (Schéma des paramètres ASP.NET)
    caching, élément (Schéma des paramètres ASP.NET)
      outputCacheSettings, élément de caching (Schéma des paramètres ASP.NET)
        outputCacheProfiles, élément de outputCacheSettings pour caching (Schéma des paramètres ASP.NET)
          add, élément de outputCacheProfiles pour caching (Schéma des paramètres ASP.NET)

<add name="String" 
     enabled="true|false" 
     duration="number" 
     location="Any|Client|Downstream|Server|None|ServerAndClient" 
     sqlDependency="String" 
     varyByCustom="String" 
     varyByControl="String" 
     varyByHeader="String" 
     varyByParam="String" 
     noStore="true|false" />

Attributs et éléments

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

Attributs

Attribut	Description
name	Attribut String requis. Définit le nom unique du profil de cache.
enabled	Attribut Boolean facultatif. Active le cache de sortie pour un profil.
duration	Attribut TimeSpan facultatif. Définit en secondes la durée de stockage d'une page dans le cache.
location	Attribut Int32 facultatif. Détermine l'emplacement de stockage autorisé pour la réponse mise en cache.
sqlDependency	Attribut String facultatif. Définit la dépendance de cache SQL au niveau de la page.
varyByCustom	Attribut String facultatif. Définit la chaîne qui est utilisée lors de l'appel à varyByCustom pour la page.
varyByControl	Attribut String facultatif. Définit l'ID du contrôle à mettre en cache et utilisé lors de l'appel à varyByControl. Peut également être défini dans une liste d'ID délimitée par des points-virgules.
varyByHeader	Attribut String facultatif. Nomme un jeu d'en-têtes séparés par des points-virgules utilisé pour faire varier la sortie mise en cache.
varyByParam	Attribut String facultatif. Nomme un jeu de paramètres séparés par des points-virgules utilisé pour faire varier la sortie mise en cache.
noStore	Attribut Boolean facultatif. Définit une valeur indiquant si la directive "Cache-Control: no-store" est envoyée dans la réponse pour les pages mises en cache.

Éléments enfants

Aucune.

Éléments parents

Élément	Description
configuration	Élément racine obligatoire de chaque fichier de configuration utilisé par le Common Language Runtime et les applications .NET Framework.
system.web	Spécifie l'élément racine pour les paramètres de configuration ASP.NET dans un fichier de configuration. Contient des éléments de configuration qui configurent les applications Web ASP.NET et contrôlent le comportement des applications.
caching	Configure les paramètres du cache pour une application Web.
outputCacheSettings	Spécifie les paramètres du cache de sortie qui peuvent être appliqués aux pages dans une application ASP.NET.
outputCacheProfiles	Contient des groupes de paramètres du cache qui peuvent être appliqués aux pages pour spécifier la directive OutputCache.

Notes

Configuration par défaut

L'élément add par défaut suivant n'est pas configuré explicitement dans le fichier de configuration machine ou dans le fichier racine Web.config, mais il s'agit de la configuration par défaut retournée par une application dans .NET Framework version 2.0.

<add name = "" 
  enabled = "true" 
  duration = "-1" 
  location = "" 
  sqlDependency = "" 
  varyByCustom = "" 
  varyByControl = "" 
  varyByHeader = "" 
  varyByParam = "" 
  noStore = "false"/>

Exemple

L'exemple suivant met en cache une page sur le serveur pendant une minute seulement et stocke des versions différentes de la page selon le type de navigateur et la version principale.

<outputCacheSettings>
  <outputCacheProfiles>
    <add name="ServerOnly" 
         duration="60" 
         varyByCustom="browser" 
         location="Server" />
  </outputCacheProfiles>
</outputCacheSettings>

Lors de la conception d'une page qui doit être mise en cache de cette manière, vous devez ajouter la directive suivante à la page :

<%@ OutputCache CacheProfile="ServerOnly" %>

Pour plus d'informations, consultez @ OutputCache.

Informations sur les éléments

Gestionnaire de section de configuration	System.Web.Configuration.OutputCacheSettingsSection
Membre de configuration	OutputCacheSettingsSection.OutputCacheProfiles
Emplacements configurables	Machine.config Web.config de niveau racine Web.config de niveau application
Configuration requise	IIS versions 5.0, 5.1 et 6.0 .NET Framework version 2.0 Visual Studio 2005

Voir aussi

Partager via

add, élément de outputCacheProfiles pour caching (Schéma des paramètres ASP.NET)

Attributs et éléments

Attributs

Éléments enfants

Éléments parents

Notes

Configuration par défaut

Exemple

Informations sur les éléments

Voir aussi

Tâches

Concepts

Référence

Autres ressources

Ressources supplémentaires