Freigeben über


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

Gibt die Ausgabecache-Profileinstellungen an, die auf die Seiten in einer ASP.NET-Anwendung angewendet werden können.

<outputCacheSettings>
    <outputCacheProfiles>...</outputCacheProfiles>
</outputCacheSettings>

Attribute und Elemente

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

Attribute

Keine.

Untergeordnete Elemente

Element

Beschreibung

outputCacheProfiles

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

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

Hinweise

Standardkonfiguration

Das folgende outputCacheSettings-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

SystemWebCachingSectionGroup.OutputCacheSettings

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

Exemplarische Vorgehensweise: Verwenden der Ausgabecachefunktion zur Verbesserung der Websiteleistung

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)

outputCacheProfiles-Element für outputCacheSettings 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