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

Configure les paramètres du cache pour une application Web.

<caching>
   <cache>...</cache>
   <outputCache>...</outputCache>
   <outputCacheSettings>...</outputCacheSettings>
   <sqlCacheDependency>...</sqlCacheDependency>
</caching>

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
Cache	Élément facultatif. Définit des paramètres de cache d'application globaux.
outputCache	Élément facultatif. Spécifie des paramètres de cache de sortie au niveau de l'application.
outputCacheSettings	Élément facultatif. Spécifie des paramètres de cache de sortie qui peuvent être appliqués aux pages dans l'application.
sqlCacheDependency	Élément facultatif. Configure les dépendances de cache SQL pour une application ASP.NET.

Éléments parents

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

Notes

Configuration par défaut

L'élément caching par défaut suivant n'est pas configuré explicitement dans le fichier Machine.config 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.

<caching>
  <cache disableMemoryCollection = "false" 
    disableExpiration = "false" 
    privateBytesLimit = "0" 
    percentagePhysicalMemoryUsedLimit = "90" 
    privateBytesPollTime = "00:02:00"/>

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

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

  <sqlCacheDependency enabled = "true" 
    pollTime = "60000">
    <databases>
       <clear />
      <add name = "" 
        connectionStringName = "" 
        pollTime = "60000"/>
    </databases>
  </sqlCacheDependency>

</caching>

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.CacheSection System.Web.Configuration.OutputCacheSection System.Web.Configuration.OutputCacheSettingsSection System.Web.Configuration.SqlCacheDependencySection
Membre de configuration	System.Web.Configuration.SystemWebCachingSectionGroup
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

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)

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

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

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

System.Configuration

System.Web.Configuration

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

Autres ressources

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

Paramètres de configuration ASP.NET

Administration de site Web ASP.NET

Fichiers de configuration ASP.NET

API de configuration ASP.NET