SqlDependency Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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 sealedpublic sealed class SqlDependencytype SqlDependency = classPublic NotInheritable Class SqlDependency- Héritage
-
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. |
| Equals(Object) |
Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object) |
| GetHashCode() |
Fait office de fonction de hachage par défaut. (Hérité de Object) |
| GetType() |
Obtient le Type de l'instance actuelle. (Hérité de Object) |
| MemberwiseClone() |
Crée une copie superficielle du Object actuel. (Hérité de Object) |
| 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 antérieur. |
| Stop(String, String) |
Arrête un écouteur pour une connexion spécifiée dans un appel Start antérieur. |
| ToString() |
Retourne une chaîne qui représente l'objet actuel. (Hérité de Object) |
Événements
| OnChange |
Se produit lorsqu'une notification est reçue pour les commandes associées à cet objet SqlDependency. |
