Partager via


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

Mise à jour : novembre 2007

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 dans Microsoft SQL Server 2000 ou SQL Server 2005. Ce paramètre de configuration n'a aucun effet lors de l'utilisation de l'élément sqlCacheDependency avec des notifications de requête dans SQL Server 2005.

configuration, élément (Schéma des paramètres généraux)
  system.web, élément (Schéma des paramètres ASP.NET)
    caching, élément (Schéma des paramètres ASP.NET)
      sqlCacheDependency, élément de caching (Schéma des paramètres ASP.NET)

<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

Comment : configurer des répertoires spécifiques à l'aide des paramètres d'emplacement

Comment : verrouiller des paramètres de configuration ASP.NET

Concepts

Vue d'ensemble de la mise en cache ASP.NET

Hiérarchie du fichier de configuration ASP.NET et héritage

Sécurisation de la configuration ASP.NET

Scénarios de configuration ASP.NET

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)

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

System.Configuration

System.Web.Configuration

Autres ressources

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

Paramètres de configuration ASP.NET

Administration de sites Web ASP.NET

Fichiers de configuration ASP.NET

API de configuration ASP.NET