Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Fügt der Konfigurationsauflistung ein OutputCacheProfile-Objekt hinzu. Auf Cacheprofile kann nur von der @ OutputCache-Direktive für Seiten verwiesen werden. Profile werden in Benutzersteuerelementen oder Serversteuerelementen nicht unterstützt.
<add name="String"
enabled="true|false"
duration="number"
location="Any|Client|Downstream|Server|None|ServerAndClient"
sqlDependency="String"
varyByCustom="String"
varyByControl="String"
varyByHeader="String"
varyByParam="String"
noStore="true|false" />
Attribute und Elemente
In den folgenden Abschnitten werden Attribute, untergeordnete Elemente und übergeordnete Elemente beschrieben.
Attribute
Attribute |
Beschreibung |
|---|---|
name |
Erforderliches String-Attribut. Legt den eindeutigen Namen des Cacheprofils fest. |
enabled |
Optionales Boolean-Attribut. Aktiviert den Ausgabecache für ein Profil. |
duration |
Optionales TimeSpan-Attribut. Legt den Zeitraum in Sekunden fest, für den eine Seite im Cache gespeichert wird. |
location |
Optionales Int32-Attribut. Bestimmt, wo die zwischengespeicherte Antwort gespeichert werden kann. |
sqlDependency |
Optionales String-Attribut. Legt die SQL-Cacheabhängigkeit auf Seitenebene fest. |
varyByCustom |
Optionales String-Attribut. Legt die Zeichenfolge fest, die beim Aufrufen von varyByCustom für die Seite verwendet wird. |
varyByControl |
Optionales String-Attribut. Legt die ID des Steuerelements fest, das beim Aufrufen von varyByControl zwischengespeichert und verwendet werden soll. Kann auch auf eine durch Semikola getrennte Liste von IDs festgelegt werden. |
varyByHeader |
Optionales String-Attribut. Benennt eine durch Semikola getrennte Gruppe von Headern, mit denen die zwischengespeicherte Ausgabe verändert wird. |
varyByParam |
Optionales String-Attribut. Benennt eine durch Semikola getrennte Gruppe von Parametern, mit denen die zwischengespeicherte Ausgabe verändert wird. |
noStore |
Optionales Boolean-Attribut. Legt einen Wert fest, der angibt, ob die "Cache-Control: no-store"-Direktive als Antwort für zwischengespeicherte Seiten gesendet wird. |
Untergeordnete Elemente
Keine.
Übergeordnete Elemente
Element |
Beschreibung |
|---|---|
configuration |
Das erforderliche Stammelement 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 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. |
outputCacheSettings |
Gibt die Ausgabecacheeinstellungen an, die auf Seiten in einer ASP.NET-Anwendung angewendet werden können. |
outputCacheProfiles |
Enthält Gruppen von Cacheeinstellungen, die auf Seiten angewendet werden können, um die OutputCache-Direktive anzugeben. |
Hinweise
Standardkonfiguration
Das folgende add-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.
<add name = ""
enabled = "true"
duration = "-1"
location = ""
sqlDependency = ""
varyByCustom = ""
varyByControl = ""
varyByHeader = ""
varyByParam = ""
noStore = "false"/>
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 |
|
Konfigurationsmember |
|
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
Referenz
system.web-Element (ASP.NET-Einstellungsschema)
configuration-Element (allgemeines Einstellungsschema)
caching-Element (ASP.NET-Einstellungsschema)
outputCacheSettings-Element für caching (ASP.NET-Einstellungsschema)
outputCacheProfiles-Element für outputCacheSettings für caching (ASP.NET-Einstellungsschema)
Konzepte
Übersicht über das Zwischenspeichern in ASP.NET
ASP.NET-Konfigurationsdateihierarchie und Vererbung
Absichern der ASP.NET-Konfiguration
ASP.NET-Konfigurationsszenarios
Weitere Ressourcen
Allgemeine Konfigurationseinstellungen (ASP.NET)