Freigeben über


<namedCaches> Element (Cacheeinstellungen)

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

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

Syntax

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

Typ

None

Attribute und Elemente

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

Attribute

Merkmal Description
cacheMemoryLimitMegabytes Ein ganzzahliger Wert, der die maximal zulässige Größe in Megabyte angibt, auf die eine Instanz einer MemoryCache Größe wachsen kann. Der Standardwert ist 0. Dies bedeutet, dass die automatischen Heuristiken der MemoryCache Klasse standardmäßig verwendet werden.
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 verbraucht werden kann. Der Standardwert ist 0. Dies bedeutet, dass die automatischen Heuristiken der MemoryCache Klasse standardmäßig verwendet werden.
pollingInterval Ein Wert, der das Zeitintervall angibt, nach dem die Cacheimplementierung die aktuelle Speicherauslastung mit den absoluten und prozentbasierten Speichergrenzwerten vergleicht, die für die Cacheinstanz festgelegt sind. Dieser Wert wird im Format "HH:MM:SS" eingegeben.

Untergeordnete Elemente

Element Description
<hinzufügen> Fügt der namedCaches Sammlung für einen Speichercache einen benannten Cache hinzu.
<klar> Löscht die namedCaches Sammlung für einen Speichercache.
<entfernen> Entfernt einen benannten Cacheeintrag aus der namedCaches Auflistung für einen Speichercache.

Übergeordnete Elemente

Element Description
<Konfiguration> Gibt das Stammelement in jeder Konfigurationsdatei an, die von der Common Language Runtime und .NET Framework-Anwendungen verwendet wird.
<memoryCache> Definiert ein Element, das zum Konfigurieren eines Caches verwendet wird, der auf der MemoryCache Klasse basiert.
<system.runtime.caching> Enthält Typen, mit denen Sie die Ausgabezwischenspeicherung in Anwendungen implementieren können, die in .NET Framework integriert sind.

Bemerkungen

Der Konfigurationsabschnitt für den Speichercache der Web.config-Datei kann Attribute und clear Attribute für die namedCaches Sammlung enthaltenadd. remove 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 verfügt nur die Standardcacheinstanz über einen Eintrag in der Konfigurationsdatei. Die Standardcacheinstanz ist die Instanz, die von der Default Eigenschaft zurückgegeben wird.

Wenn Sie das Namensattribute auf "Default" festlegen, verwendet das Element die Standardspeichercacheinstanz.

Example

Das folgende Beispiel zeigt, wie Der Name des Caches auf den Standardnamen des Cacheeintrags festgelegt wird, indem das name Attribut auf "Default" festgelegt wird.

Das cacheMemoryLimitMegabytes Attribut und das physicalMemoryPercentage Attribut werden auf Null festgelegt. Das Festlegen dieser Attribute auf Null bedeutet, dass die automatischen Heuristiken der MemoryCache Klasse verwendet werden. Die Cacheimplementierung vergleicht die aktuelle Speicherauslastung mit den absoluten und prozentsatzbasierten Speicherlimits alle zwei Minuten.

<configuration>

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

</configuration>

Siehe auch