Partager via


<namedCaches> Élément (Paramètres du cache)

Spécifie une collection de paramètres de configuration pour les instances nommées MemoryCache . La NamedCaches propriété fait référence à la collection de paramètres de configuration à partir d’un ou plusieurs namedCaches éléments 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.

Attributes

Caractéristique Descriptif
cacheMemoryLimitMegabytes Valeur entière qui spécifie la taille maximale autorisée, en mégaoctets, vers laquelle une instance d’un MemoryCache peut croître. La valeur par défaut est 0, ce qui signifie que les heuristiques de dimensionnement automatique de la MemoryCache classe sont utilisées 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 physiquement installée pouvant être consommée par le cache. La valeur par défaut est 0, ce qui signifie que les heuristiques de dimensionnement automatique de la MemoryCache classe sont utilisées par défaut.
pollingInterval Valeur qui indique l’intervalle de temps après lequel l’implémentation du cache compare la charge de mémoire actuelle par rapport aux limites absolues et en pourcentage de mémoire définies pour l’instance de cache. Cette valeur est entrée au format « HH :MM :SS ».

Éléments enfants

Élément Descriptif
<ajouter> Ajoute un cache nommé à la namedCaches collection pour un cache mémoire.
<clair> Efface la collection d’un namedCaches cache de mémoire.
<enlever> Supprime une entrée de cache nommée de la namedCaches collection pour un cache mémoire.

Éléments parents

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

Remarques

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

Vous pouvez récupérer des instances d’entrées de cache de 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 Default propriété.

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

Example

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

L’attribut cacheMemoryLimitMegabytes et l’attribut physicalMemoryPercentage sont définis sur zéro. La définition de ces attributs sur zéro signifie que les heuristiques de dimensionnement automatique de la MemoryCache classe sont utilisées. L’implémentation du cache compare la charge de mémoire actuelle par rapport aux limites absolues et de mémoire basées sur des pourcentages 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>

Voir aussi