Partager via


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

Mise à jour : novembre 2007

Spécifie les paramètres du profil du cache de sortie qui peuvent être appliqués aux pages dans une application ASP.NET.

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)

<outputCacheSettings>
    <outputCacheProfiles>...</outputCacheProfiles>
</outputCacheSettings>

Attributs et éléments

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

Attributs

Aucun.

Éléments enfants

Élément

Description

outputCacheProfiles

Contient des groupes de paramètres du cache qui peuvent être appliqués aux pages pour spécifier la directive OutputCache.

Éléments parents

Élément

Description

configuration

Élément racine requis 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.

Notes

Configuration par défaut

L'élément outputCacheSettings 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 le .NET Framework version 2.0.

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

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

SystemWebCachingSectionGroup.OutputCacheSettings

Emplacements configurables

Machine.config

Web.config de niveau racine

Web.config de niveau application

Configuration requise

IIS 5.0, 5.1 et 6.0

.NET Framework 2.0

Visual Studio 2005

Voir aussi

Tâches

Procédure pas à pas : utilisation de la mise en cache de sortie pour améliorer les performances d'un site Web

Comment : configurer des répertoires spécifiques à l'aide des paramètres d'emplacement

Comment : verrouiller des paramètres de configuration ASP.NET

Concepts

Vue d'ensemble de la mise en cache ASP.NET

Hiérarchie du fichier de configuration ASP.NET et héritage

Sécurisation de la configuration ASP.NET

Scénarios de configuration ASP.NET

Référence

system.web, élément (Schéma des paramètres ASP.NET)

configuration, élément (Schéma des paramètres généraux)

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

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

System.Configuration

System.Web.Configuration

Autres ressources

Paramètres généraux de configuration (ASP.NET)

Paramètres de configuration ASP.NET

Administration de sites Web ASP.NET

Fichiers de configuration ASP.NET

API de configuration ASP.NET