OutputCacheProfile-Klasse

Konfiguriert das Ausgabecacheprofil für die Seiten einer Webanwendung.

Syntax

class OutputCacheProfile : CollectionElement  

Methoden

Diese Klasse enthält keine Methoden.

Eigenschaften

In der folgenden Tabelle sind die Eigenschaften aufgeführt, die von der OutputCacheProfile Klasse verfügbar gemacht werden.

Name	Beschreibung
Duration	Ein Lese-/Schreibsint32-Wert, der die Zeit in Sekunden angibt, zu der die Seite oder das Benutzersteuerelement zwischengespeichert wird. Der Standardwert ist –1. Wenn Sie dieses Attribut auf einer Seite oder einem Benutzersteuerelement festlegen, wird eine Ablaufrichtlinie für HTTP-Antworten von der Seite oder dem Benutzersteuerelement festgelegt und die Seiten- oder Benutzersteuerungsausgabe automatisch zwischengespeichert. Hinweis: Diese Eigenschaft muss entweder im Profil oder in der @ OutputCache Direktive einer Seite definiert werden, die das Profil verwendet.
Enabled	Ein Lese-/Schreibboolean-Wert. true wenn die Zwischenspeicherung für alle Seiten oder Steuerelemente aktiviert ist, die dieses Ausgabecacheprofil verwenden; andernfalls , false. Der Standardwert ist true.
Location	Ein Lese-/Schreibsint32-Wert, der den Speicherort des Caches angibt. Die möglichen Werte werden weiter unten im Abschnitt Hinweise aufgeführt.
Name	Ein schreibgeschützter string Wert, der den Namen des Ausgabecacheprofils angibt.
NoStore	Ein Lese-/Schreibboolean-Wert. true wenn die Seite einen Cache-Control: Private no-store Header in der HTTP-Antwort ausgibt, die den Browser angibt, die Seite nicht zwischenzuspeichern, andernfalls, false. Der Standardwert ist false. Hinweis: Das Festlegen dieses Attributs true entspricht dem Aufrufen der System.Web.HttpCachePolicy.SetNoStore-Methode während einer Webanforderung.
SqlDependency	Ein Lese-/Schreibstring-Wert, der eine Gruppe von SQL-Datenbank- und Tabellennamenpaaren identifiziert, von denen der Ausgabecache einer Seite oder eines Steuerelements abhängt. Wenn Sie eine Zeichenfolge für diese Eigenschaft angeben, können zwischengespeicherte Seiten aus dem Cache entfernt werden, wenn die SQL-Tabelle, von der sie abhängig sind, geändert wird.
VaryByControl	Ein Lese-/Schreibstring-Wert, der einen durch Trennzeichen getrennten Satz von IDs von Steuerelementen angibt, die zwischengespeichert werden sollen. Hinweis: Die Einstellungen für diese Eigenschaft sind identisch mit denen VaryByControls des Attributs der @ OutputCache Direktive.
VaryByCustom	Ein durch Trennzeichen getrennter Lese-./Schreibstring-Wert, der benutzerdefinierte Anforderungen für die Ausgabezwischenspeicherung darstellt. Wenn Sie dieser Eigenschaft den Wert von "browser" zuweisen, ist der Cache nach Browsername und Hauptversionsinformationen unterschiedlich. Wenn Sie eine benutzerdefinierte Zeichenfolge eingeben, müssen Sie die GetVaryByCustomString Methode in der Datei "Global.asax" für Ihre Anwendung überschreiben. Hinweis: Die Einstellungen für diese Eigenschaft sind identisch mit denen VaryByCustom des Attributs der @ OutputCache Direktive.
VaryByHeader	Ein Lese-/Schreibstring-Wert, der einen durch Trennzeichen getrennten Satz von HTTP-Headern angibt, die der Anforderung zugeordnet sind und verwendet werden, um die zwischengespeicherte Ausgabe zu variieren. Hinweis: Die Einstellungen für diese Eigenschaft sind identisch mit denen VaryByHeader des Attributs der @ OutputCache Direktive.
VaryByParam	Ein string Wert, der einen durch Trennzeichen getrennten Satz von Parametern angibt, die die zwischengespeicherte Ausgabe von GET-Abfragezeichenfolge oder POST-Parametern des Formulars variieren. Hinweis: Die Einstellungen für diese Eigenschaft sind identisch mit denen VaryByParam des Attributs der @ OutputCache Direktive.

Unterklassen

Diese Klasse enthält keine Unterklassen.

Hinweise

Instanzen dieser Klasse sind in der OutputCacheProfiles Arrayeigenschaft der OutputCacheProfileSettings-Klasse enthalten.

In der folgenden Tabelle werden die verschiedenen möglichen Werte für die Location Eigenschaft angezeigt.

Wert	Schlüsselwort	Beschreibung
0	Any	Die Seite wird auf dem Server, allen HTTP 1.1-kompatiblen Proxys und dem Client zwischengespeichert. Dieser Wert entspricht dem Wert "System.Web.HttpCacheability.Public ".
1	Client	Die Seite wird nur auf dem Clienten zwischengespeichert, auf dem die Anforderung stammt. Dieser Wert entspricht dem System.Web.HttpCacheability.Private-Enumeration-Wert..
2	Downstream	Die Seite wird auf allen HTTP 1.1-cachefähigen Geräten zwischengespeichert, mit Ausnahme des ursprünglichen Servers. Cachefähige Geräte enthalten Proxyserver und den Client, der die Anforderung gestellt hat.
3	Server	Die Seite wird nur auf dem Webserver zwischengespeichert, auf dem die Anforderung verarbeitet wurde. Dieser Wert entspricht dem System.Web.HttpCacheability.Server-Enumeration-Wert.
4	None	Die Seite ist nicht zwischengespeichert. Dieser Wert entspricht dem System.Web.HttpCacheability.NoCacheability.NoCacheEnumeration-Wert.
5	ServerAndClient	Die Seite wird nur auf dem ursprünglichen Server oder auf dem anfordernden Client zwischengespeichert. Die Zwischenspeicherung der Antwort durch Proxyserver ist nicht zulässig. Dieser Wert entspricht der Kombination der System.Web.HttpCacheability.Private- und der System.Web.HttpCacheability.Server-Enumeration-Werten.

Vererbungshierarchie

CollectionElement

OutputCacheProfile

Anforderungen

type	Beschreibung
Client	IIS 7.0 unter Windows Vista. IIS 7.5 unter Windows 7 IIS 8.0 unter Windows 8 IIS 10.0 unter Windows 10
Server	IIS 7.0 unter Windows Server 2008 - IIS 7.5 unter Windows Server 2008 R2 IIS 8.0 auf Windows Server 2012. - IIS 8.5 unter Windows Server 2012 R2 IIS 10.0 auf Windows Server 2016.
Produkt	- IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0
MOF-Datei	WebAdministration.mof

Weitere Informationen

System.Web.HttpCachePolicy.SetNoStoreSystem.Web.HttpCacheabilitySystem.Web.UI.OutputCacheLocation
CollectionElement-Klasse
OutputCacheSection-Klasse
OutputCache Einstellungen Section-Klasse
OutputCacheProfileSettings-Klasse
SqlCacheDependencySection-Klasse
@ OutputCache
Zwischenspeichern mehrerer Versionen der Benutzersteuerungsausgabe