caching-Element (ASP.NET-Einstellungsschema)

  • Artikel

[Dieses Dokument dient lediglich Vorschauzwecken und kann in späteren Versionen geändert werden. Leere Themen sind als Platzhalter enthalten.]

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 sowie untergeordnete 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 in 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 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

How to: Configure Specific Folders Using Location Settings

How to: Lock ASP.NET Configuration Settings

Referenz

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

configuration-Element (allgemeines Einstellungsschema)

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

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

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

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

System.Configuration

System.Web.Configuration

Konzepte

ASP.NET Caching Overview

ASP.NET Configuration File Hierarchy

Securing Configuration

Configuration Inheritance

Weitere Ressourcen

Allgemeine Konfigurationseinstellungen (ASP.NET)

ASP.NET-Konfigurationseinstellungen

Configuring ASP.NET Applications

ASP.NET Configuration Files

ASP.NET Configuration API