Freigeben über


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

Aktualisiert: November 2007

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

configuration-Element (allgemeines Einstellungsschema)
  system.web-Element (ASP.NET-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)

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

Attribute und Elemente

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

Attribute

Keins.

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

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 Web.config-Stammdatei 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

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)

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

Weitere Ressourcen

Allgemeine Konfigurationseinstellungen (ASP.NET)

ASP.NET-Konfigurationseinstellungen

Verwalten von ASP.NET-Websites

ASP.NET-Konfigurationsdateien

ASP.NET-Konfigurations-API