Freigeben über

cache-Element für caching (ASP.NET-Einstellungsschema)

  • Artikel

Aktualisiert: November 2007

Definiert Cacheeinstellungen, die für eine gesamte ASP.NET-Webanwendung gelten.

configuration-Element (allgemeines Einstellungsschema)
  system.web-Element (ASP.NET-Einstellungsschema)
    caching-Element (ASP.NET-Einstellungsschema)
      cache-Element für caching (ASP.NET-Einstellungsschema)

<cache disableMemoryCollection="true|false" 
       disableExpiration="true|false" 
       privateBytesLimit="number" 
       percentagePhysicalMemoryUsedLimit="number" 
       privateBytesPollTime="HH:MM:SS" />

Attribute und Elemente

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

Attribute

Attribut

Beschreibung

disableMemoryCollection

Optionales Boolean-Attribut.

Ruft einen Wert ab, der angibt, ob die Cachespeicherauflistung deaktiviert ist, die eintritt, wenn sich der Computer unter Speicherdruck befindet, oder ruft diesen Wert ab.

disableExpiration

Optionales Boolean-Attribut.

Ruft einen Wert ab, der angibt, ob die Ablaufzeit für den Cache deaktiviert ist, oder legt diesen fest. Wenn dieses Attribut deaktiviert ist, laufen zwischengespeicherte Elemente nicht ab, und der Aufräumvorgang von abgelaufenen Cacheelementen im Hintergrund wird nicht ausgeführt.

privateBytesLimit

Optionales Int64-Attribut.

Ruft einen Wert ab, der die maximale Größe der privaten Bytes einer Anwendung angibt, bevor der Cache abgelaufene Elemente löscht und versucht, Speicherplatz freizugeben, oder legt diesen Wert fest. Dieser Grenzwert schließt sowohl vom Cache verwendeten Speicherplatz als auch die normale Arbeitsspeicherauslastung durch die ausgeführte Anwendung ein. Die Einstellung 0 (null) gibt an, dass ASP.NET mit eigenen Heuristiken bestimmt, wann Speicher wieder freigegeben wird.

percentagePhysicalMemoryUsedLimit

Optionales Int32-Attribut.

Ruft einen Wert ab, der den maximalen Prozentsatz des physischen Speichers eines Computers angibt, der verwendet werden kann, bevor der Cache abgelaufene Elemente löscht und versucht, Speicherplatz freizugeben, oder legt diesen Wert fest. Beachten Sie, dass der Grenzwert für den gesamten verwendeten physischen Speicher gilt. Die Einstellung 0 führt dazu, dass Einträge so schnell, wie sie eingefügt werden, direkt entfernt werden.

privateBytesPollTime

Optionales TimeSpan-Attribut.

Ruft einen Wert ab, der das Zeitintervall zwischen einzelnen Abrufvorgängen der Speicherauslastung durch die privaten Bytes der Anwendung angibt, oder legt diesen Wert fest.

Untergeordnete Elemente

Keine.

Übergeordnete Elemente

Element

Beschreibung

configuration

Das erforderliche Stammelement in jeder Konfigurationsdatei, die von der Common Language Runtime und den .NET Framework-Anwendungen verwendet wird.

system.web

Gibt das Stammelement für die ASP.NET-Konfigurationseinstellungen in einer Konfigurationsdatei an. Enthält Konfigurationselemente, die ASP.NET-Webanwendungen konfigurieren und das Verhalten der Anwendungen steuern.

caching

Konfiguriert die Cacheeinstellungen für eine Webanwendung.

Hinweise

Standardkonfiguration

Das folgende cache-Standardelement wird nicht explizit in der Computerkonfigurationsdatei oder Web.config-Stammdatei konfiguriert, sondern stellt die von einer Anwendung in .NET Framework, Version 2.0, zurückgegebene Standardkonfiguration dar.

<cache disableMemoryCollection="false" 
  disableExpiration="false" privateBytesLimit="0" 
  percentagePhysicalMemoryUsedLimit="90" 
  privateBytesPollTime="00:02:00" />

Beispiel

Im folgenden Beispiel werden die globalen Cacheeinstellungen für eine ASP.NET-Anwendung festgelegt.

<cache disableMemoryCollection = "false" 
  disableExpiration = "false" 
  privateBytesLimit = "20971520" 
  percentagePhysicalMemoryUsedLimit = 60" 
  privateBytesPollTime = "00:01:00"/>

Elementinformationen

Konfigurationsabschnittshandler

System.Web.Configuration.CacheSection

Konfigurationsmember

Cache

Konfigurierbare Speicherorte

Machine.config

Web.config auf der Stammebene

Web.config auf der Anwendungsebene

Voraussetzungen

IIS, Version 5.0, 5.1 und 6.0

.NET Framework, Version 2.0

Visual Studio 2005

Siehe auch

Aufgaben

Gewusst wie: Konfigurieren von bestimmten Verzeichnissen mit Standorteinstellungen

Gewusst wie: Sperren von ASP.NET-Konfigurationseinstellungen

Konzepte

Cachekonfiguration in ASP.NET

Übersicht über das Zwischenspeichern in ASP.NET

ASP.NET-Konfigurationsdateihierarchie und Vererbung

Absichern der ASP.NET-Konfiguration

ASP.NET-Konfigurationsszenarios

Referenz

system.web-Element (ASP.NET-Einstellungsschema)

configuration-Element (allgemeines Einstellungsschema)

cache-Element für caching (ASP.NET-Einstellungsschema)

System.Configuration

System.Web.Configuration

Weitere Ressourcen

Allgemeine Konfigurationseinstellungen (ASP.NET)

ASP.NET-Konfigurationseinstellungen

Verwalten von ASP.NET-Websites

ASP.NET-Konfigurationsdateien

ASP.NET-Konfigurations-API