<namedCaches>-Element (Cacheeinstellungen)

Gibt eine Auflistung der Konfigurationseinstellungen für die benannten MemoryCache-Instanzen ab. Die NamedCaches-Eigenschaft verweist auf die Auflistung der Konfigurationseinstellungen von einem oder mehreren namedCaches-Elementen der Konfigurationsdatei.

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

None

Attribute und Elemente

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

Attribute

Attribute

Beschreibungen

CacheMemoryLimitMegabytes

Ein Ganzzahlwert, der die maximale zulässige Größe in Megabytes angibt, auf die eine Instanz eines MemoryCache anwachsen kann. Der Standardwert ist 0, d. h., dass die Heuristik zur automatischen Größenanpassung der MemoryCache-Klasse standardmäßig verwendet wird.

Name

Der Name des Caches.

PhysicalMemoryLimitPercentage

Ein ganzzahliger Wert zwischen 0 und 100, die den maximalen Prozentsatz von physisch installiertem Speicher angibt, der vom Cache belegt werden kann. Der Standardwert ist 0, d. h., dass die Heuristik zur automatischen Größenanpassung der MemoryCache-Klasse standardmäßig verwendet wird.

PollingInterval

Ein Wert, der das Zeitintervall angibt, nach dem die Cacheimplementierung die aktuelle Arbeitsspeicherlast mit den absoluten und prozentualen Arbeitsspeicherlimits vergleicht, die für die Cacheinstanz festgelegt sind, oder legt diesen fest. Dieser Wert wird im "HH:MM:SS"-Format eingegeben.

Untergeordnete Elemente

Element

Beschreibungen

<add>

Fügt der namedCaches-Auflistung ein einen benannten Cache für einen Speichercache hinzu.

<clear>

Löscht die namedCaches-Auflistung für eine Speichercache.

<remove>

Entfernt aus der namedCaches-Auflistung einen benannten Cacheeintrag für einen Speichercache.

Übergeordnete Elemente

Element

Beschreibungen

<memoryCache>

Definiert ein Element, das verwendet wird, um einen auf der MemoryCache-Klasse basierenden Cache zu konfigurieren.

Hinweise

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

Sie können Instanzen von Arbeitsspeichercacheeinträgen abrufen, indem Sie die Informationen in den Anwendungskonfigurationsdateien mit Verweisen versehen. Standardmäßig weist nur die Standardcacheinstanz einen Eintrag in der Konfigurationsdatei auf. Die Standardcacheinstanz ist die Instanz, die von der Default-Eigenschaft zurückgegeben wird.

Wenn Sie das Namensattribut auf "Standard" festlegten, verwendet das Element die Standardarbeitsspeichercacheinstanz.

Beispiel

Im folgenden Beispiel wird gezeigt, wie der Name des Caches auf den standardmäßigen Cacheeintragsnamen festgelegt wird, indem das name-Attribut auf "Standard" gesetzt wird.

Das cacheMemoryLimitMegabytes-Attribut und das physicalMemoryPercentage-Attribut sind auf null gesetzt. Das Festlegen dieser Attribute auf 0 (null) bedeutet, dass die Heuristik zur automatischen Größenanpassung der MemoryCache-Klasse verwendet wird. Die Cacheimplementierung vergleicht alle zwei Minuten die aktuelle Arbeitsspeicherlast mit den absoluten und prozentualen Arbeitsspeicherlimits.

<configuration>

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

</configuration>

Siehe auch

Referenz

<memoryCache>-Element (Cacheeinstellungen)