<add>-Element für <namedCaches>

Artikel
06/22/2023

Fügt der Auflistung namedCaches einen namedCache-Eintrag für einen Speichercache hinzu.

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

Syntax

<namedCaches>  
    <add name="Default" />  
      <!-- child elements -->  
 </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 der MemoryCache-Klasse für die automatische Größenanpassung 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 der MemoryCache-Klasse für die automatische Größenanpassung 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

None

Übergeordnete Elemente

Element	BESCHREIBUNG
<namedCaches>	Dieses Element enthält eine Sammlung von Konfigurationseinstellungen für die benannten MemoryCache-Instanzen.

Bemerkungen

Das add-Element fügt der Auflistung namedCaches einen Eintrag für einen Speichercache hinzu. Sie können das clear-Element verwenden, bevor Sie das add-Element verwenden, um sicherzustellen, dass die Auflistung keine anderen benannten Caches enthält. Dieses Element kann in der Datei „machine.config“ und in der Datei „Web.config“ verwendet werden.

Beispiel

Das folgende Beispiel zeigt, wie Sie Einstellungen für den Standardeintrag namedCache in der Auflistung namedCaches für einen Speichercache definieren.

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