Freigeben über


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

Aktualisiert: November 2007

Definiert die von der SqlCacheDependency-Klasse bei der Datenbank-Zwischenspeicherung und beim tabellenbasierten Abrufen mit Microsoft SQL Server 2000 oder SQL Server 2005 verwendeten Einstellungen. Diese Konfigurationseinstellung hat keine Auswirkungen, wenn das sqlCacheDependency-Element in Verbindung mit Abfragebenachrichtigungen in SQL Server 2005 verwendet wird.

configuration-Element (allgemeines Einstellungsschema)
  system.web-Element (ASP.NET-Einstellungsschema)
    caching-Element (ASP.NET-Einstellungsschema)
      sqlCacheDependency-Element für caching (ASP.NET-Einstellungsschema)

<sqlCacheDependency enabled="true|false" 
                    pollTime="number">
    <databases>...</databases>
</sqlCacheDependency>

Attribute und Elemente

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

Attribute

Attribut

Beschreibung

enabled

Erforderliches Boolean-Attribut.

Gibt an, ob Änderungen abgerufen werden.

pollTime

Optionales Int32-Attribut.

Legt die Häufigkeit fest, mit der die SqlCacheDependency-Klasseninstanz Änderungen aus der Datenbanktabelle abruft. Dieser Wert entspricht der Anzahl von Millisekunden zwischen den einzelnen Abrufen. Er kann nicht auf weniger als 500 Millisekunden festgelegt werden.

Der Standardwert beträgt 1 Minute.

Untergeordnete Elemente

Element

Beschreibung

databases

Optionales Element.

Enthält eine oder mehrere benannte SQL-Verbindungen, die von der SqlCacheDependency-Klasseninstanz verwendet werden können.

Übergeordnete Elemente

Element

Beschreibung

configuration

Das erforderliche Stammelement in jeder von der Common Language Runtime und den .NET Framework-Anwendungen verwendeten Konfigurationsdatei.

system.web

Gibt das Stammelement für die ASP.NET-Konfigurationseinstellungen in einer Konfigurationsdatei an. Enthält Elemente, die ASP.NET-Webanwendungen konfigurieren und das Verhalten der Anwendungen steuern.

caching

Konfiguriert die Cacheeinstellungen für eine Webanwendung.

Hinweise

Standardkonfiguration

Das folgende sqlCacheDependency-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.

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

Beispiel

Im folgenden Beispiel wird einer ASP.NET-Anwendung ein SqlCacheDependency-Objekt hinzugefügt.

<sqlCacheDependency enabled="true" pollTime="30000">
  <databases>
    <add name="Pubs" connectionStringName="PubsConn" />
  </databases>
</sqlCacheDependency>

Elementinformationen

Konfigurationsabschnittshandler

System.Web.Configuration.SqlCacheDependencySection

Konfigurationsmember

SqlCacheDependency

Konfigurierbare Speicherorte

Machine.config

Web.config auf der Stammebene

Web.config auf der Anwendungsebene

Voraussetzungen

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)

databases-Element für sqlCacheDependency 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