SqlDependency SqlDependency SqlDependency SqlDependency Class

Définition

L'objet SqlDependency représente une dépendance de notification de requête entre une application et une instance SQL Server.The SqlDependency object represents a query notification dependency between an application and an instance of 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.An application can create a SqlDependency object and register to receive notifications via the OnChangeEventHandler event handler.

public ref class SqlDependency sealed
public sealed class SqlDependency
type SqlDependency = class
Public NotInheritable Class SqlDependency
Héritage
SqlDependencySqlDependencySqlDependencySqlDependency

Remarques

SqlDependencyest 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 is ideal for caching scenarios, where your ASP.NET application or middle-tier service needs to keep certain information cached in memory. SqlDependencyvous 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é.SqlDependency allows you to receive notifications when the original data in the database changes so that the cache can be refreshed.

Pour configurer une dépendance, vous devez associer un SqlDependency objet à un ou plusieurs SqlCommand objets.To set up a dependency, you need to associate a SqlDependency object to one or more SqlCommand objects. Pour recevoir des notifications, vous devez vous abonner à l' OnChange événement.To receive notifications, you need to subscribe to the OnChange event. 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.For more information about the requirements for creating queries for notifications, see Working with Query Notifications.

Notes

SqlDependencya été conçu pour être utilisé dans ASP.NET ou les services de niveau intermédiaire où il existe un nombre relativement faible de serveurs ayant des dépendances actives sur la base de données.SqlDependency was designed to be used in ASP.NET or middle-tier services where there is a relatively small number of servers having dependencies active against the database. Il n’a pas été conçu pour être utilisé dans les applications clientes, où des centaines ou SqlDependency des milliers d’ordinateurs clients auraient des objets configurés pour un serveur de base de données unique.It was not designed for use in client applications, where hundreds or thousands of client computers would have SqlDependency objects set up for a single database server. Si vous développez une application où vous avez besoin de notifications de sous-secondes fiables en cas de modification des données, consultez les sections planification d’une stratégie de notifications de requêtes efficaces et alternatives aux notifications de requête dans la planification de Article sur les notifications.If you are developing an application where you need reliable sub-second notifications when data changes, review the sections Planning an Efficient Query Notifications Strategy and Alternatives to Query Notifications in the Planning for Notifications article.

Pour plus d’informations, consultez notifications de requêtes dans SQL Server et génération de solutions de notification.For more information, see Query Notifications in SQL Server and Building Notification Solutions.

Notes

L' OnChange événement peut être généré sur un thread différent du thread qui a initié l’exécution de la commande.The OnChange event may be generated on a different thread from the thread that initiated command execution.

Les notifications de requête ne sont prises en charge que pour les instructions SELECT qui répondent à une liste de spécifications précises.Query notifications are supported only for SELECT statements that meet a list of specific requirements.

Constructeurs

SqlDependency() SqlDependency() SqlDependency() SqlDependency()

Crée une nouvelle instance de la classe SqlDependency avec les paramètres par défaut.Creates a new instance of the SqlDependency class with the default settings.

SqlDependency(SqlCommand) SqlDependency(SqlCommand) SqlDependency(SqlCommand) SqlDependency(SqlCommand)

Crée une instance de la classe SqlDependency et l'associe au paramètre SqlCommand.Creates a new instance of the SqlDependency class and associates it with the SqlCommand parameter.

SqlDependency(SqlCommand, String, Int32) SqlDependency(SqlCommand, String, Int32) SqlDependency(SqlCommand, String, Int32) 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.Creates a new instance of the SqlDependency class, associates it with the SqlCommand parameter, and specifies notification options and a time-out value.

Propriétés

HasChanges HasChanges HasChanges HasChanges

Obtient une valeur qui indique si l'un des ensembles de résultats associés à la dépendance a changé.Gets a value that indicates whether one of the result sets associated with the dependency has changed.

Id Id Id Id

Obtient une valeur qui identifie uniquement cette instance de la classe SqlDependency.Gets a value that uniquely identifies this instance of the SqlDependency class.

Méthodes

AddCommandDependency(SqlCommand) AddCommandDependency(SqlCommand) AddCommandDependency(SqlCommand) AddCommandDependency(SqlCommand)

Associe un objet SqlCommand à cette instance de SqlDependency.Associates a SqlCommand object with this SqlDependency instance.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fait office de fonction de hachage par défaut.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crée une copie superficielle de l'objet Object actuel.Creates a shallow copy of the current Object.

(Inherited from Object)
Start(String) Start(String) Start(String) 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.Starts the listener for receiving dependency change notifications from the instance of SQL Server specified by the connection string.

Start(String, String) Start(String, String) Start(String, String) 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.Starts the listener for receiving dependency change notifications from the instance of SQL Server specified by the connection string using the specified SQL Server Service Broker queue.

Stop(String) Stop(String) Stop(String) Stop(String)

Arrête un écouteur pour une connexion spécifiée dans un appel Start antérieur.Stops a listener for a connection specified in a previous Start call.

Stop(String, String) Stop(String, String) Stop(String, String) Stop(String, String)

Arrête un écouteur pour une connexion spécifiée dans un appel Start antérieur.Stops a listener for a connection specified in a previous Start call.

ToString() ToString() ToString() ToString()

Retourne une chaîne qui représente l'objet actuel.Returns a string that represents the current object.

(Inherited from Object)

Événements

OnChange OnChange OnChange OnChange

Se produit lorsqu'une notification est reçue pour les commandes associées à cet objet SqlDependency.Occurs when a notification is received for any of the commands associated with this SqlDependency object.

S’applique à

Voir aussi