<memoryCache>, élément (Paramètres de cache)

Article
08/10/2011

Définit un élément qui est utilisé pour configurer un cache basé sur la classe MemoryCache. La classe MemoryCacheElement définit un élément memoryCache que vous pouvez utiliser pour configurer le cache. Plusieurs instances de la classe MemoryCache peuvent être utilisées dans une application unique. Chaque élément memoryCache dans le fichier de configuration peut contenir des paramètres pour une instance MemoryCache nommée.

<memoryCache 
    <namedCaches>
        <!-- child elements -->
    </namedCaches> 
< memoryCache />

la classe MemoryCache ;

Attributs et éléments

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

Attributs

Attribut	Description
CacheMemoryLimitMegabytes	La taille de mémoire maximale, en mégaoctets, qu'une instance d'un objet MemoryCache peut atteindre. La valeur par défaut est 0, ce qui signifie que l'heuristique de redimensionnement automatique de la classe MemoryCache est utilisée par défaut.
Name	Nom de la configuration de cache.
PhysicalMemoryLimitPercentage	Le pourcentage de mémoire physique que le cache peut utiliser. La valeur par défaut est 0, ce qui signifie que l'heuristique de redimensionnement automatique de la classe MemoryCache est utilisée par défaut.
PollingInterval	Valeur qui indique l'intervalle de temps à l'issue duquel l'implémentation de cache compare la charge de mémoire actuelle aux limites de mémoire absolue et sous forme de pourcentage définies pour l'instance de cache. La valeur est entrée au format « HH:MM:SS ».

Éléments enfants

Élément	Description
<namedCaches>	Contient une collection de paramètres de configuration pour l'instance namedCache.

Éléments parents

Élément	Description
<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.

Notes

La classe MemoryCache est une implémentation concrète de la classe ObjectCache abstraite. Les instances de la classe MemoryCache peuvent être fournies avec les informations de configuration à partir des fichiers de configuration de l'application. La section de configuration memoryCache contient une collection de configuration de namedCaches.

Lorsqu'un objet cache basé sur mémoire est initialisé, il essaie d'abord de rechercher une entrée namedCaches qui correspond au nom dans le paramètre passé au constructeur du cache mémoire. Si une entrée namedCaches est trouvée, les informations d'interrogation et de gestion de mémoire sont extraites du fichier de configuration.

Le processus d'initialisation détermine ensuite si des entrées de configuration ont été substituées, en utilisant la collection facultative de paires nom/valeur d'informations de configuration dans le constructeur. Si vous passez l'une des valeurs suivantes dans la collection de paires nom/valeur, ces valeurs remplacent les informations obtenues dans le fichier de configuration :

Exemple

L'exemple suivant montre comment définir le nom de l'objet MemoryCache sur le nom d'objet cache par défaut en donnant à l'attribut name la valeur « par défaut ».

La valeur des attributs cacheMemoryLimitMegabytes et physicalMemoryPercentage est définie à zéro. Si ces attributs sont définis sur zéro, les méthodes heuristiques de redimensionnement automatique MemoryCache sont utilisées par défaut. L'implémentation de cache doit comparer la charge de mémoire actuelle aux limites de mémoire absolue et sous forme de pourcentage toutes les deux minutes.

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

Voir aussi

Référence

<system.runtime.caching>, élément (Paramètres de cache)

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

MemoryCache

Partager via