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