Partager via


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

Mise à jour : novembre 2007

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

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)

<outputCacheProfiles>
    <add.../>
    <clear />
    <remove.../>
</outputCacheProfiles>

Attributs et éléments

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

Attributs

Aucune.

Éléments enfants

Élément

Description

add

Élément facultatif.

Ajoute un objet OutputCacheProfile à la collection de configurations.

clear

Élément facultatif.

Supprime tous les objets OutputCacheProfile de la collection de configurations.

remove

Élément facultatif.

Supprime de la collection de configurations l'objet OutputCacheProfile portant le nom spécifié.

É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.

outputCacheSettings

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

Notes

Configuration par défaut

L'élément outputCacheProfiles 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

OutputCacheSettingsSection.OutputCacheProfiles

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

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)

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

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

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

remove, élément de outputCacheProfiles 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