caching, élément (Schéma des paramètres ASP.NET)
Mise à jour : novembre 2007
Configure les paramètres du cache pour une application Web.
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)
<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
Aucune.
É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 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. |
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 |
Membre de configuration |
|
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)
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)
Autres ressources
Paramètres généraux de configuration (ASP.NET)
Paramètres de configuration ASP.NET
Administration de sites Web ASP.NET