outputCache-Element für caching (ASP.NET-Einstellungsschema)
Aktualisiert: November 2007
Gibt die Ausgabecacheeinstellungen an, die die gesamte Anwendung betreffen.
configuration-Element (allgemeines Einstellungsschema)
system.web-Element (ASP.NET-Einstellungsschema)
caching-Element (ASP.NET-Einstellungsschema)
outputCache-Element für caching (ASP.NET-Einstellungsschema)
<outputCache enableOutputCache="true|false"
enableFragmentCache="true|false"
sendCacheControlHeader="true|false"
omitVaryStar="true|false">
</outputCache>
Attribute und Elemente
In den folgenden Abschnitten werden Attribute, untergeordnete Elemente und übergeordnete Elemente beschrieben.
Attribute
Attribut |
Beschreibung |
|---|---|
enableOutputCache |
Optionales Boolean-Attribut. Aktiviert/deaktiviert den Seitenausgabecache. Wenn der Cache deaktiviert ist, erfolgt keine Zwischenspeicherung der Seiten, unabhängig von den programmgesteuerten und deklarativen Einstellungen. Der Standardwert ist true. |
enableFragmentCache |
Optionales Boolean-Attribut. Aktiviert/deaktiviert den Anwendungsfragmentcache. Wenn der Cache deaktiviert ist, erfolgt keine Zwischenspeicherung der Seiten, unabhängig von der verwendeten @ OutputCache-Direktive oder dem verwendeten Zwischenspeicherungsprofil. Enthält einen Cache-Control-Header, der angibt, dass weder Upstream-Proxyserver noch Browserclients versuchen sollten, die Seitenausgabe zwischenzuspeichern. Der Standardwert ist false. |
sendCacheControlHeader |
Optionales Boolean-Attribut. Ruft einen Wert ab, der angibt, ob der cache-control:private-Header in der Standardeinstellung vom Ausgabecachemodul gesendet wird. Der Standardwert ist false. |
omitVaryStar |
Optionales Boolean-Attribut. Aktiviert/deaktiviert das Senden eines "Vary: *"-HTTP-Headers in der Antwort. Mit der Standardeinstellung false wird ein "Vary: *"-Header für die Seiten im Ausgabecache gesendet. Der Standardwert ist false. |
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 outputCache-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.
<outputCache enableOutputCache = "true"
enableFragmentCache = "true"
sendCacheControlHeader = "true"
omitVaryStar = "false">
</outputCache>
Beispiel
Im folgenden Beispiel wird der Ausgabecache für eine ASP.NET-Anwendung deaktiviert.
<outputCache enableOutputCache="false" />
Elementinformationen
Konfigurationsabschnittshandler |
|
Konfigurationsmember |
|
Konfigurierbare Speicherorte |
Machine.config Web.config auf der Stammebene Web.config auf der Anwendungsebene |
Anforderungen |
IIS, Version 5.0, IIS, Version 5.1, und IIS, Version 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
Ü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)
Weitere Ressourcen
Allgemeine Konfigurationseinstellungen (ASP.NET)
ASP.NET-Konfigurationseinstellungen