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 de SQL Server. Une application peut créer un SqlDependency objet et s’inscrire pour recevoir des notifications via le 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 les conditions requises pour créer des requêtes pour les notifications, consultez Utilisation des notifications de requête.
Note
SqlDependency a été conçu pour être utilisé dans des services de niveau intermédiaire ou de ASP.NET, où il existe un nombre relativement faible de serveurs ayant des dépendances actives sur la base de données. Elle n’a pas été conçue pour être utilisée 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 Query Notifications dans SQL Server et Building Notification Solutions.
Note
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
| Nom | Description |
|---|---|
| SqlDependency() |
Crée une instance de la SqlDependency classe avec les paramètres par défaut. |
| SqlDependency(SqlCommand, String, Int32) |
Crée une instance de la SqlDependency classe, l’associe au SqlCommand paramètre et spécifie les options de notification et une valeur de délai d’attente. |
| SqlDependency(SqlCommand) |
Crée une instance de la SqlDependency classe et l’associe au SqlCommand paramètre. |
Propriétés
| Nom | Description |
|---|---|
| HasChanges |
Obtient une valeur qui indique si l’un des jeux de résultats associés à la dépendance a changé. |
| Id |
Obtient une valeur qui identifie de façon unique cette instance de la SqlDependency classe. |
Méthodes
| Nom | Description |
|---|---|
| AddCommandDependency(SqlCommand) |
Associe un SqlCommand objet à cette SqlDependency instance. |
| Equals(Object) |
Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object) |
| GetHashCode() |
Sert de fonction de hachage par défaut. (Hérité de Object) |
| GetType() |
Obtient la Type de l’instance actuelle. (Hérité de Object) |
| MemberwiseClone() |
Crée une copie superficielle du Objectactuel. (Hérité de Object) |
| Start(String, String) |
Démarre l’écouteur pour recevoir des notifications de modification de dépendance à partir de l’instance de SQL Server spécifiée par l’chaîne de connexion à l’aide de la file d’attente service Broker spécifiée SQL Server. |
| Start(String) |
Démarre l’écouteur pour recevoir des notifications de modification de dépendance à partir de l’instance de SQL Server spécifiée par le chaîne de connexion. |
| Stop(String, String) |
Arrête un écouteur pour une connexion spécifiée dans un appel précédent Start . |
| Stop(String) |
Arrête un écouteur pour une connexion spécifiée dans un appel précédent Start . |
| ToString() |
Retourne une chaîne qui représente l’objet actuel. (Hérité de Object) |
Événements
| Nom | Description |
|---|---|
| OnChange |
Se produit lorsqu’une notification est reçue pour l’une des commandes associées à cet SqlDependency objet. |