Partager via

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

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

<Configuration>
   <System.runtime.caching>
     <memoryCache>

Syntaxe

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

Catégorie

MemoryCache classe.

Attributs et éléments

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

Attributs

Caractéristique Descriptif
CacheMemoryLimitMegabytes Taille maximale de mémoire, en mégaoctets, vers laquelle une instance d’un MemoryCache objet peut croître. La valeur par défaut est 0, ce qui signifie que les heuristiques de taille automatique de la MemoryCache classe sont utilisées par défaut. (Ce paramètre est uniquement effectif sur .Net Framework.)
Name Nom de la configuration du cache.
PhysicalMemoryLimitPercentage pourcentage de l’utilisation totale de la mémoire physique sur le système (par tous les processus) auquel le cache commence à supprimer les entrées. La valeur par défaut est 0, ce qui signifie que les heuristiques de taille 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. La valeur est entrée au format « HH :MM :SS ».

Éléments enfants

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

É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.
<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 MemoryCache classe est une implémentation concrète de la classe abstraite ObjectCache . Les instances de la MemoryCache classe peuvent être fournies avec des informations de configuration à partir de fichiers de configuration d’application. La section de configuration memoryCache contient une namedCaches collection de configuration.

Lorsqu’un objet de cache basé sur la mémoire est initialisé, il tente d’abord de trouver une namedCaches entrée qui correspond au nom dans le paramètre passé au constructeur du cache de mémoire. Si une namedCaches entrée est trouvée, les informations d’interrogation et de gestion de la mémoire sont récupérées à partir du fichier de configuration.

Le processus d’initialisation détermine ensuite si des entrées de configuration ont été remplacées, à l’aide de la collection facultative de paires nom/valeur d’informations de configuration dans le constructeur. Si vous transmettez l’une des valeurs suivantes dans la collection de paires nom/valeur, ces valeurs remplacent les informations obtenues à partir du fichier de configuration :

Exemple :

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

L’attribut cacheMemoryLimitMegabytes et l’attribut physicalMemoryLimitPercentage sont définis sur zéro. La définition de ces attributs sur zéro signifie que les MemoryCache heuristiques de dimensionnement automatique sont utilisées par défaut. L’implémentation du cache doit comparer 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

  • Last updated on