Freigeben über


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

Enthält Gruppen von Cacheeinstellungen, die auf Seiten angewendet werden können, um die @OutputCache-Direktive anzugeben.

<outputCacheProfiles>
    <add.../>
    <clear />
    <remove.../>
</outputCacheProfiles>

Attribute und Elemente

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

Attribute

Keine.

Untergeordnete Elemente

Element

Beschreibung

add

Optionales Element

Fügt der Konfigurationsauflistung ein OutputCacheProfile-Objekt hinzu.

clear

Optionales Element.

Entfernt alle OutputCacheProfile-Objekte aus der Konfigurationsauflistung.

remove

Optionales Element.

Entfernt das OutputCacheProfile-Objekt mit dem angegebenen Namen aus der Konfigurationsauflistung.

Ü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 die Seiten und Steuerelemente in einer ASP.NET-Anwendung angewendet werden können.

Hinweise

Standardkonfiguration

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

<outputCacheSettings>
  <outputCacheProfiles>
    <add name = ""
      enabled = "true"
      duration = "-1"
      location = ""
      sqlDependency = ""
      varyByCustom = ""
      varyByControl = ""
      varyByHeader = ""
      varyByParam = ""
      noStore = "false"/>
  </outputCacheProfiles>
</outputCacheSettings>
<outputCacheSettings>
  <outputCacheProfiles>
    <clear />
  </outputCacheProfiles>
</outputCacheSettings>

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.OutputCacheSettingsSection

Konfigurationsmember

OutputCacheSettingsSection.OutputCacheProfiles

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

Referenz

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

configuration-Element (allgemeines Einstellungsschema)

caching-Element (ASP.NET-Einstellungsschema)

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

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

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

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

System.Configuration

System.Web.Configuration

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)

ASP.NET-Konfigurationseinstellungen

ASP.NET-Websiteverwaltung

ASP.NET-Konfigurationsdateien

ASP.NET-Konfigurations-API