SqlDependency Classe

Définition

Espace de noms:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Paquet:

Microsoft.Data.SqlClient v5.2.0

L'objet SqlDependency représente une dépendance de notification de requête entre une application et une instance SQL Server. Une application peut créer un objet SqlDependency et l'enregistrer pour recevoir des notifications par le biais du gestionnaire d'événements OnChangeEventHandler.

public ref class SqlDependency sealed

public sealed class SqlDependency

type SqlDependency = class

Public NotInheritable Class SqlDependency

Héritage

Object

SqlDependency

Remarques

SqlDependency est idéal pour les scénarios de mise en cache, où votre application ASP.NET ou votre service de niveau intermédiaire doit conserver certaines informations mises en cache en mémoire. SqlDependency vous permet de recevoir des notifications lorsque les données d’origine de la base de données changent afin que le cache puisse être actualisé.

Pour configurer une dépendance, vous devez associer un SqlDependency objet à un ou plusieurs SqlCommand objets. Pour recevoir des notifications, vous devez vous abonner à l’événement OnChange . Pour plus d’informations sur la configuration requise pour la création de requêtes pour les notifications, consultez Utilisation des notifications de requête.

Notes

SqlDependency a été conçu pour être utilisé dans les services ASP.NET ou de niveau intermédiaire où il existe un nombre relativement faible de serveurs ayant des dépendances actives par rapport à la base de données. Il n’a pas été conçu pour une utilisation dans les applications clientes, où des centaines ou des milliers d’ordinateurs clients auraient SqlDependency des objets configurés pour un serveur de base de données unique. Si vous développez une application pour laquelle vous avez besoin de notifications fiables à la fraction de seconde près lorsque des données sont modifiées, consultez les sections Planification d’une stratégie efficace de notifications de requête et Alternatives aux notifications de requête de l’article Planification des notifications.

Pour plus d’informations, consultez Notifications de requête dans SQL Server et Création de solutions de notification.

Notes

L’événement OnChange peut être généré sur un thread différent du thread qui a lancé l’exécution de la commande.

Les notifications de requêtes sont prises en charge uniquement pour les instructions SELECT qui répondent à une liste d’exigences suivantes.

Constructeurs

SqlDependency()	Crée une nouvelle instance de la classe SqlDependency avec les paramètres par défaut.
SqlDependency(SqlCommand)	Crée une instance de la classe SqlDependency et l'associe au paramètre SqlCommand.
SqlDependency(SqlCommand, String, Int32)	Crée une instance de la classe SqlDependency, l'associe au paramètre SqlCommand et spécifie des options de notification et une valeur de délai d'attente.

Propriétés

HasChanges	Obtient une valeur qui indique si l'un des ensembles de résultats associés à la dépendance a changé.
Id	Obtient une valeur qui identifie uniquement cette instance de la classe SqlDependency.

Méthodes

AddCommandDependency(SqlCommand)	Associe un objet SqlCommand à cette instance de SqlDependency.
Start(String)	Démarre l'écouteur pour recevoir des notifications de modification de dépendance à partir de l'instance SQL Server spécifiée par la chaîne de connexion.
Start(String, String)	Démarre l'écouteur pour recevoir des notifications de modification de dépendance de l'instance SQL Server spécifiée par la chaîne de connexion à l'aide de la file d'attente SQL Server Service Broker spécifiée.
Stop(String)	Arrête un écouteur pour une connexion spécifiée dans un appel Start(String) antérieur.
Stop(String, String)	Arrête un écouteur pour une connexion spécifiée dans un appel Start(String, String) antérieur.

Événements

OnChange

Se produit lorsqu'une notification est reçue pour les commandes associées à cet objet SqlDependency.