<namedCaches>, élément (paramètres de cache)

Article
05/09/2023

Spécifie une collection de paramètres de configuration pour les instances MemoryCache nommées. La propriété NamedCaches fait référence à la collection de paramètres de configuration d’un ou plusieurs éléments namedCaches du fichier de configuration.

<configuration>
  <system.runtime.caching>
    <memoryCache>
      <namedCaches>

Syntaxe

<namedCaches>  
  <add name="Default"/>
</namedCaches>

Type

None

Attributs et éléments

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

Attributs

Attribut	Description
`cacheMemoryLimitMegabytes`	Valeur spécifiant la taille maximale autorisée, en mégaoctets, qu’une instance d’un MemoryCache peut atteindre. La valeur par défaut est 0, ce qui signifie que l’heuristique de dimensionnement automatique de la classe MemoryCache est utilisée par défaut.
`name`	Nom du cache.
`physicalMemoryLimitPercentage`	Valeur entière comprise entre 0 et 100 qui spécifie le pourcentage maximal de mémoire ordinateur installée physiquement qui peut être consommé par le cache. La valeur par défaut est 0, ce qui signifie que l’heuristique de dimensionnement automatique de la classe MemoryCache est utilisée par défaut.
`pollingInterval`	Valeur qui indique l’intervalle de temps après lequel l’implémentation de cache compare la charge de mémoire actuelle aux limites de mémoire absolue et en pourcentage définies pour l’instance de cache. La valeur est entrée au format « HH:MM:SS ».

Éléments enfants

Élément	Description
<add>	Ajoute un cache nommé à la collection `namedCaches` d’un cache mémoire.
<clear>	Efface la collection `namedCaches` pour un cache mémoire.
<remove>	Supprime une entité de cache nommé de la collection `namedCaches` d’un cache mémoire.

Éléments parents

Élément	Description
<configuration>	Spécifie l’élément racine dans chaque fichier de configuration utilisé par le Common Language Runtime et les applications .NET Framework.
<memoryCache>	Définit un élément qui est utilisé pour configurer un cache basé sur la classe MemoryCache .
<system.runtime.caching>	Contient des types qui vous permettent d’implémenter la mise en cache de sortie dans les applications intégrées à .NET Framework.

Notes

La section de configuration du cache mémoire du fichier Web.config peut contenir des attributs add, remove et clear pour la collection namedCaches. Chaque entrée namedCaches est identifiée de manière unique par l’attribut name.

Vous pouvez récupérer des instances d’entrées de cache mémoire en référençant les informations dans les fichiers de configuration de l’application. Par défaut, seule l’instance de cache par défaut a une entrée dans le fichier de configuration. L’instance de cache par défaut est l’instance retournée par la propriété Default.

Si vous définissez l’attribut de nom sur « Default », l’élément utilise l’instance de cache mémoire par défaut.

Exemple

L’exemple suivant montre comment définir le nom du cache sur le nom d’entrée de cache par défaut en affectant la valeur « Default » à l’attribut name.

Les attributs cacheMemoryLimitMegabytes et physicalMemoryPercentage sont définis sur zéro. La définition de ces attributs sur zéro signifie que l’heuristique de dimensionnement automatique de la classe MemoryCache est utilisée. L’implémentation du cache compare la charge de mémoire actuelle aux limites de mémoire en valeur absolue et en pourcentage toutes les deux minutes.

<configuration>  
  
  <system.runtime.caching>  
    <memoryCache>  
      <namedCaches>  
          <add name="Default"
               cacheMemoryLimitMegabytes="0"
               physicalMemoryLimitPercentage="0"  
               pollingInterval="00:02:00" />  
      </namedCaches>  
    </memoryCache>  
  </system.runtime.caching>  
  
</configuration>