Freigeben über


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

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

Definiert die von der SqlCacheDependency-Klasse bei der Datenbankzwischenspeicherung 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.

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

Attribute und Elemente

In den folgenden Abschnitten werden Attribute sowie untergeordnete 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

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)

caching-Element (ASP.NET-Einstellungsschema)

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