sqlCacheDependency, élément de caching (Schéma des paramètres ASP.NET)

[Cette documentation constitue un aperçu et pourra faire l'objet de modifications dans les versions ultérieures. Des rubriques vierges sont incluses en tant qu'espaces réservés.]

Définit les paramètres utilisés par la classe SqlCacheDependency pour la mise en cache de base de données et l'interrogation basée sur des tables avec Microsoft SQL Server 2000 ou SQL Server 2005. Ce paramètre de configuration n'a aucun effet lorsque vous utilisez l'élément sqlCacheDependency conjointement avec des notifications de requête sur SQL Server 2005.

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

Attributs et éléments

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.

Attributs

Attribut

Description

enabled

Attribut Boolean requis.

Indique si des interrogations ont été effectuées sur des modifications.

pollTime

Attribut Int32 facultatif.

Définit la fréquence à laquelle l'instance de la classe SqlCacheDependency interroge la table de base de données pour effectuer les modifications. Cette valeur correspond au nombre de millisecondes entre des interrogations consécutives. La valeur ne doit pas être inférieure à 500 millisecondes.

La valeur par défaut est de 1 minute.

Éléments enfants

Élément

Description

databases

Élément facultatif.

Contient une ou plusieurs connexions SQL nommées qui peuvent être utilisées par l'instance de la classe SqlCacheDependency.

Éléments parents

Élément

Description

configuration

Élément racine obligatoire de chaque fichier de configuration utilisé par le Common Language Runtime et les applications .NET Framework.

system.web

Spécifie l'élément racine pour les paramètres de configuration ASP.NET dans un fichier de configuration. Contient des éléments qui configurent les applications Web ASP.NET et contrôlent le comportement des applications.

caching

Configure les paramètres du cache pour une application Web.

Notes

Configuration par défaut

L'élément sqlCacheDependency par défaut suivant n'est pas configuré explicitement dans le fichier de configuration machine ou dans le fichier racine Web.config, mais il s'agit de la configuration par défaut retournée par une application dans .NET Framework version 2.0.

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

Exemple

L'exemple suivant ajoute un objet SqlCacheDependency à une application ASP.NET.

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

Informations sur les éléments

Gestionnaire de section de configuration

System.Web.Configuration.SqlCacheDependencySection

Membre de configuration

SqlCacheDependency

Emplacements configurables

Machine.config

Web.config racine

Web.config au niveau de l'application

Configuration requise

IIS 5.0, 5.1 et 6.0

.NET Framework 2.0

Visual Studio 2005

Voir aussi

Tâches

How to: Configure Specific Folders Using Location Settings

How to: Lock ASP.NET Configuration Settings

Référence

system.web, élément (Schéma des paramètres ASP.NET)

configuration, élément (Schéma des paramètres généraux)

caching, élément (Schéma des paramètres ASP.NET)

databases, élément de sqlCacheDependency pour caching (Schéma des paramètres ASP.NET)

System.Configuration

System.Web.Configuration

Concepts

ASP.NET Caching Overview

ASP.NET Configuration File Hierarchy

Securing Configuration

Configuration Inheritance

Autres ressources

Paramètres généraux de configuration (ASP.NET)

Paramètres de configuration ASP.NET

Configuring ASP.NET Applications

ASP.NET Configuration Files

ASP.NET Configuration API