Partager via


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

Mise à jour : novembre 2007

Spécifie des paramètres de cache de sortie au niveau de l'application.

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)
      outputCache, élément de caching (Schéma des paramètres ASP.NET)

<outputCache enableOutputCache="true|false" 
             enableFragmentCache="true|false" 
             sendCacheControlHeader="true|false" 
             omitVaryStar="true|false">
</outputCache>

Attributs et éléments

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

Attributs

Attribut

Description

enableOutputCache

Attribut Boolean facultatif.

Active/désactive le cache de sortie de page.

S'il est désactivé, aucune page n'est mise en cache indépendamment des paramètres de programmation ou déclaratifs.

La valeur par défaut est true.

enableFragmentCache

Attribut Boolean facultatif.

Active/désactive le cache de fragment de l'application.

S'il est désactivé, aucune page n'est mise en cache indépendamment de la directive @ OutputCache ou du profil de mise en cache utilisé. Inclut un en-tête Cache-Control indiquant que des serveurs proxy amont ainsi que des clients de navigateur ne doivent pas tenter de mettre en cache la sortie de page.

La valeur par défaut est false.

sendCacheControlHeader

Attribut Boolean facultatif.

Obtient ou définit une valeur qui indique si l'en-tête cache-control:private est envoyé par défaut par le module de cache de sortie.

La valeur par défaut est false.

omitVaryStar

Attribut Boolean facultatif.

Active/désactive l'envoi d'un en-tête HTTP "Vary: *" dans la réponse. Lorsque le paramètre par défaut est false, un en-tête "Vary: * " est envoyé pour les pages mises en cache de sortie.

La valeur par défaut est false.

Éléments enfants

Aucun.

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

Notes

Configuration par défaut

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

<outputCache enableOutputCache = "true" 
             enableFragmentCache = "true" 
             sendCacheControlHeader = "true" 
             omitVaryStar = "false">
</outputCache>

Exemple

L'exemple suivant désactive le cache de sortie pour une application ASP.NET.

<outputCache enableOutputCache="false" />

Informations sur les éléments

Gestionnaire de section de configuration

System.Web.Configuration.OutputCacheSection

Membre de configuration

SystemWebCachingSectionGroup.OutputCache

Emplacements configurables

Machine.config

Web.config de niveau racine

Web.config de niveau application

Configuration requise

IIS version 5.0, IIS version 5.1 et IIS version 6.0

.NET Framework version 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)

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