Partager via

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

  • Article

Définit des paramètres de cache au niveau de l'application pour une application Web ASP.NET.

<cache disableMemoryCollection="true|false" 
       disableExpiration="true|false" 
       privateBytesLimit="number" 
       percentagePhysicalMemoryUsedLimit="number" 
       privateBytesPollTime="HH:MM:SS" />

Attributs et éléments

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

Attributs

Attribut

Description

disableMemoryCollection

Attribut Boolean facultatif.

Obtient ou définit une valeur indiquant si la collection de mémoires cache qui se produit lorsque l'ordinateur qui sollicite la mémoire est désactivée.

disableExpiration

Attribut Boolean facultatif.

Obtient ou définit une valeur indiquant si l'expiration du cache est désactivée. Lorsqu'elle est désactivée, les éléments mis en cache n'expirent pas et le nettoyage d'arrière-plan d'éléments du cache expirés ne se produit pas.

privateBytesLimit

Attribut Int64 facultatif.

Obtient ou définit une valeur indiquant la taille maximale des octets privés d'une application avant que le cache ne commence à vider les éléments expirés et tente de récupérer de la mémoire. Cette limite inclut à la fois la mémoire utilisée par le cache ainsi que la charge de mémoire normale à partir de l'application actuelle. Un paramètre de zéro indique qu'ASP.NET utilisera ses propres heuristiques pour déterminer le moment pour commencer à récupérer de la mémoire.

percentagePhysicalMemoryUsedLimit

Attribut Int32 facultatif.

Obtient ou définit une valeur qui indique le pourcentage maximum de la mémoire physique d'un ordinateur pouvant être utilisé avant que le cache ne commence à vider des éléments et à essayer de récupérer de la mémoire. Notez que la limite s'applique à la mémoire physique totale utilisée. Paramètre de 0 résultat dans les entrées supprimées immédiatement, aussi rapidement qu'elles sont insérées.

privateBytesPollTime

Attribut TimeSpan facultatif.

Obtient ou définit une valeur indiquant l'intervalle de temps entre les interrogations relatives à l'utilisation de la mémoire d'octets privés.

Éléments enfants

Aucun

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

caching

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

Notes

Configuration par défaut

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

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

Exemple

L'exemple suivant définit les paramètres de cache global pour une application ASP.NET.

<cache disableMemoryCollection = "false" 
  disableExpiration = "false" 
  privateBytesLimit = "20971520" 
  percentagePhysicalMemoryUsedLimit = 60" 
  privateBytesPollTime = "00:01:00"/>

Informations sur les éléments

Gestionnaire de section de configuration

System.Web.Configuration.CacheSection

Membre de configuration

Cache

Emplacements configurables

Machine.config

Web.config de niveau racine

Web.config de niveau application

Configuration requise

IIS versions 5.0, 5.1 et 6.0

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

System.Configuration

System.Web.Configuration

Concepts

Configuration du cache dans ASP.NET

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