caching-Element (ASP.NET-Einstellungsschema)
Aktualisiert: November 2007
Konfiguriert die Cacheeinstellungen für eine Webanwendung.
configuration-Element (allgemeines Einstellungsschema)
system.web-Element (ASP.NET-Einstellungsschema)
caching-Element (ASP.NET-Einstellungsschema)
<caching>
<cache>...</cache>
<outputCache>...</outputCache>
<outputCacheSettings>...</outputCacheSettings>
<sqlCacheDependency>...</sqlCacheDependency>
</caching>
Attribute und Elemente
In den folgenden Abschnitten werden Attribute, untergeordnete Elemente und übergeordnete Elemente beschrieben.
Attribute
Keins.
Untergeordnete Elemente
Element |
Beschreibung |
|---|---|
Cache |
Optionales Element. Definiert globale Anwendungscacheeinstellungen. |
outputCache |
Optionales Element. Gibt die Ausgabecacheeinstellungen an, die die gesamte Anwendung betreffen. |
outputCacheSettings |
Optionales Element. Gibt die Ausgabecacheeinstellungen an, die auf die Seiten in der Anwendung angewendet werden können. |
sqlCacheDependency |
Optionales Element. Konfiguriert die SQL-Cacheabhängigkeiten für eine ASP.NET-Anwendung. |
Ü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. |
Hinweise
Standardkonfiguration
Das folgende caching-Standardelement wird nicht explizit in der Datei Machine.config oder der Stammdatei Web.config konfiguriert, sondern stellt die von einer Anwendung in .NET Framework, Version 2.0, zurückgegebene Standardkonfiguration dar.
<caching>
<cache disableMemoryCollection = "false"
disableExpiration = "false"
privateBytesLimit = "0"
percentagePhysicalMemoryUsedLimit = "90"
privateBytesPollTime = "00:02:00"/>
<outputCache enableOutputCache = "true"
enableFragmentCache = "true"
sendCacheControlHeader = "true"
omitVaryStar = "false" >
</outputCache>
<outputCacheSettings>
<outputCacheProfiles>
<clear />
<add name = ""
enabled = "true"
duration = "-1"
location = ""
sqlDependency = ""
varyByCustom = ""
varyByControl = ""
varyByHeader = ""
varyByParam = ""
noStore = "false"/>
</outputCacheProfiles>
</outputCacheSettings>
<sqlCacheDependency enabled = "true"
pollTime = "60000">
<databases>
<clear />
<add name = ""
connectionStringName = ""
pollTime = "60000"/>
</databases>
</sqlCacheDependency>
</caching>
Beispiel
Im folgenden Beispiel wird eine Seite nur eine Minute lang auf dem Server zwischengespeichert. Außerdem werden verschiedene Versionen der Seite auf Grundlage des Browsertyps und der Hauptversion gespeichert.
<outputCacheSettings>
<outputCacheProfiles>
<add name="ServerOnly"
duration="60"
varyByCustom="browser"
location="Server" />
</outputCacheProfiles>
</outputCacheSettings>
Wenn eine Seite entworfen wird, die auf diese Weise zwischengespeichert werden muss, müssen Sie der Seite folgende Direktive hinzufügen:
<%@ OutputCache CacheProfile="ServerOnly" %>
Weitere Informationen finden Sie unter @ OutputCache.
Elementinformationen
Konfigurationsabschnittshandler |
System.Web.Configuration.CacheSection System.Web.Configuration.OutputCacheSection |
Konfigurationsmember |
|
Konfigurierbare Speicherorte |
Machine.config Web.config auf der Stammebene Web.config auf der Anwendungsebene |
Anforderungen |
IIS 5.0, 5.1 und 6.0 .NET Framework 2.0 Visual Studio 2005 |
Siehe auch
Aufgaben
Gewusst wie: Konfigurieren von bestimmten Verzeichnissen mit Standorteinstellungen
Gewusst wie: Sperren von ASP.NET-Konfigurationseinstellungen
Konzepte
Ü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)
outputCache-Element für caching (ASP.NET-Einstellungsschema)
outputCacheSettings-Element für caching (ASP.NET-Einstellungsschema)
sqlCacheDependency-Element für caching (ASP.NET-Einstellungsschema)
Weitere Ressourcen
Allgemeine Konfigurationseinstellungen (ASP.NET)
ASP.NET-Konfigurationseinstellungen