caching-Element (ASP.NET-Einstellungsschema)

2011-08-10

Konfiguriert die Cacheeinstellungen für eine Webanwendung.

<caching>
   <cache>...</cache>
   <outputCache>...</outputCache>
   <outputCacheSettings>...</outputCacheSettings>
   <sqlCacheDependency>...</sqlCacheDependency>
</caching>

Attribute und Elemente

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

Attribute

Keine.

Untergeordnete Elemente

Element	Beschreibung
Cache	Optionales Element Definiert globale Anwendungscacheeinstellungen.
outputCache	Optionales Element. Gibt die Ausgabecacheeinstellungen an, die die gesamte Anwendung betreffen.
outputCacheSettings	Optionales Element. Gibt die Ausgabecacheeinstellungen an, die auf die Seiten in der Anwendung angewendet werden können.
sqlCacheDependency	Optionales Element. Konfiguriert die SQL-Cacheabhängigkeiten für eine ASP.NET-Anwendung.

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

Hinweise

Standardkonfiguration

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

<caching>
  <cache disableMemoryCollection = "false" 
    disableExpiration = "false" 
    privateBytesLimit = "0" 
    percentagePhysicalMemoryUsedLimit = "90" 
    privateBytesPollTime = "00:02:00"/>

  <outputCache enableOutputCache = "true" 
    enableFragmentCache = "true" 
    sendCacheControlHeader = "true" 
    omitVaryStar = "false" >
  </outputCache>

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

  <sqlCacheDependency enabled = "true" 
    pollTime = "60000">
    <databases>
       <clear />
      <add name = "" 
        connectionStringName = "" 
        pollTime = "60000"/>
    </databases>
  </sqlCacheDependency>

</caching>

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.CacheSection System.Web.Configuration.OutputCacheSection System.Web.Configuration.OutputCacheSettingsSection System.Web.Configuration.SqlCacheDependencySection
Konfigurationsmember	System.Web.Configuration.SystemWebCachingSectionGroup
Konfigurierbare Verzeichnisse	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

Freigeben über

caching-Element (ASP.NET-Einstellungsschema)

Attribute und Elemente

Attribute

Untergeordnete Elemente

Übergeordnete Elemente

Hinweise

Standardkonfiguration

Beispiel

Elementinformationen

Siehe auch

Aufgaben

Referenz

Konzepte

Weitere Ressourcen

Zusätzliche Ressourcen