<namedCaches>-Element (Cacheeinstellungen)

Artikel
06/05/2023

Dieses Element enthält eine Sammlung von Konfigurationseinstellungen für die benannten MemoryCache-Instanzen. Die NamedCaches-Eigenschaft verweist auf die Sammlung von Konfigurationseinstellungen aus einem oder mehreren namedCaches-Elementen der Konfigurationsdatei.

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

Syntax

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

type

None

Attribute und Elemente

In den folgenden Abschnitten werden Attribute sowie untergeordnete und übergeordnete Elemente beschrieben.

Attribute

attribute	Beschreibung
`cacheMemoryLimitMegabytes`	Ein ganzzahliger Wert, der die maximal zulässige Größe in Megabyte angibt, auf die eine Instanz eines MemoryCache anwachsen kann. Der Standardwert ist 0, was bedeutet, dass die Heuristik zur automatischen Größenanpassung der MemoryCache-Klasse als Standard verwendet wird.
`name`	Der Name des Caches.
`physicalMemoryLimitPercentage`	Ein ganzzahliger Wert zwischen 0 und 100, der den maximalen Prozentsatz des physisch installierten Computerspeichers angibt, der vom Cache genutzt werden kann. Der Standardwert ist 0, was bedeutet, dass die Heuristik zur automatischen Größenanpassung der MemoryCache-Klasse als Standard verwendet wird.
`pollingInterval`	Ein Wert, der das Zeitintervall angibt, in dem die Cacheimplementierung die aktuelle Auslastung des Arbeitsspeichers mit den absoluten und prozentualen Speichergrenzen vergleicht, die für die Cacheinstanz festgelegt sind. Der Wert wird im Format „HH:MM:SS“ eingegeben.

Untergeordnete Elemente

Element	BESCHREIBUNG
<add>	Fügt der `namedCaches`-Sammlung für einen Speichercache einen benannten Cache hinzu.
<clear>	Löscht die `namedCaches`-Sammlung für einen Speichercache.
<remove>	Entfernt einen benannten Cacheeintrag aus der `namedCaches`-Sammlung für einen Speichercache.

Übergeordnete Elemente

Element	BESCHREIBUNG
<configuration>	Hiermit wird das Stammelement in jeder Konfigurationsdatei angegeben, die von der Common Language Runtime und .NET Framework-Anwendungen verwendet wird.
<memoryCache>	Definiert ein Element, das für die Konfiguration des Cache verwendet wird, der auf der MemoryCache -Klasse basiert.
<system.runtime.caching>	Dieses Element enthält Typen, mit denen Sie das Zwischenspeichern der Ausgabe in Anwendungen implementieren können, die im .NET Framework integriert sind.

Bemerkungen

Der Abschnitt zur Speichercachekonfiguration der Web.config-Datei kann die Attribute add, remove und clear für die Sammlung namedCaches enthalten. Jeder namedCaches-Eintrag wird durch das name-Attribut eindeutig identifiziert.

Sie können Instanzen von Speichercacheeinträgen abrufen, indem Sie auf die Informationen in den Anwendungskonfigurationsdateien verweisen. Standardmäßig enthält nur die Standardcache-Instanz einen Eintrag in der Konfigurationsdatei. Die Standardcache-Instanz ist die Instanz, die von der Default-Eigenschaft zurückgegeben wird.

Wenn Sie das name-Attribut auf „Default“ festlegen, verwendet das Element die Standardspeichercache-Instanz.

Beispiel

Im folgenden Beispiel wird veranschaulicht, wie Sie den Namen des Cache auf den Standard-Cacheeintragsnamen festlegen, indem Sie das name-Attribut auf „Default“ festlegen.

Das cacheMemoryLimitMegabytes - und das physicalMemoryPercentage -Attribut werden auf 0 (Null) festgelegt. Werden diese Attribute auf 0 (Null) festgelegt, wird die Heuristik zur automatischen Größenanpassung der MemoryCache-Klasse verwendet. Die Cache-Implementierung vergleicht die aktuelle Auslastung des Arbeitsspeichers alle zwei Minuten mit den absoluten und prozentualen Speichergrenzen.

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