SqlDependency.Start Méthode

  • Référence

Définition

Espace de noms:
System.Data.SqlClient
Assembly:
System.Data.SqlClient.dll
Assembly:
System.Data.dll
Paquet:
System.Data.SqlClient v4.8.6

Démarre l'écouteur pour recevoir des notifications de modification de dépendance.

Surcharges

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.

Remarques

L’écouteur SqlDependency redémarre lorsqu’une erreur se produit dans la connexion SQL Server.

Plusieurs appels à la Start méthode peuvent être effectués, sous réserve des restrictions suivantes :

  • Plusieurs appels avec des paramètres identiques (les mêmes chaîne de connexion et les mêmes informations d’identification Windows dans le thread appelant) sont valides.

  • Plusieurs appels avec différentes chaînes de connexion sont valides tant que :

    • Chaque chaîne de connexion spécifie une base de données différente, ou

    • Chaque chaîne de connexion spécifie un utilisateur différent, ou

    • Les appels proviennent de différents domaines d’application.

Vous pouvez faire fonctionner correctement les SqlDependency applications qui utilisent plusieurs threads pour représenter différentes informations d’identification utilisateur sans donner le rôle dbo au groupe, car différents utilisateurs peuvent s’abonner et écouter (à l’aide SqlCacheDependency ou SqlCommand) d’une file d’attente de notifications créée par un administrateur. Lorsque le domaine d’application approprié démarre, appelez Démarrer avec les informations d’identification (Windows) d’un utilisateur qui a l’autorisation d’initialiser un service/file d’attente (autorisations CREATE QUEUE et CREATE SERVICE pour la base de données). Vérifiez que Start n’est appelé qu’une seule fois par AppDomain, sinon une exception d’ambiguïté est levée. Le thread utilisateur doit avoir l’autorisation de s’abonner à la notification (l’autorisation SUBSCRIBE QUERY NOTIFICATIONS pour la base de données). SqlDependency associe la demande d’abonnement d’un utilisateur non administrateur au service/file d’attente créé par l’administrateur.

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.

public:
 static bool Start(System::String ^ connectionString);
public static bool Start (string connectionString);
static member Start : string -> bool
Public Shared Function Start (connectionString As String) As Boolean

Paramètres

connectionString
String

Chaîne de connexion de l'instance SQL Server à partir de laquelle obtenir des notifications de modification.

Retours

Boolean

true si l’écouteur a été initialisé correctement ; false si un écouteur compatible existe déjà.

Exceptions

ArgumentNullException

Le paramètre connectionString est NULL.

InvalidOperationException

Le paramètre connectionString est le même qu'un appel précédent à cette méthode, mais les paramètres sont différents.

La méthode a été appelée à partir du CLR.

SecurityException

L'appelant n'a pas l'autorisation de sécurité d'accès du code SqlClientPermission requise.

SqlException

Un appel suivant à la méthode a été effectué à l'aide d'un paramètre connectionString équivalent avec un utilisateur différent, ou un utilisateur qui n'adopte pas par défaut le même schéma.

Également, toutes les exceptions SqlClient sous-jacentes.

Remarques

Cette méthode démarre l’écouteur pour recevoir des AppDomain notifications de dépendance à partir de la instance de SQL Server spécifiée par le connectionString paramètre . Cette méthode peut être appelée plusieurs fois avec différentes chaînes de connexion pour plusieurs serveurs.

Pour obtenir des remarques supplémentaires, consultez Start.

Voir aussi

S’applique à

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.

public:
 static bool Start(System::String ^ connectionString, System::String ^ queue);
public static bool Start (string connectionString, string queue);
static member Start : string * string -> bool
Public Shared Function Start (connectionString As String, queue As String) As Boolean

Paramètres

connectionString
String

Chaîne de connexion de l'instance SQL Server à partir de laquelle obtenir des notifications de modification.

queue
String

File d'attente SQL Server Service Broker existante à utiliser. Si la valeur est null, la file d'attente par défaut est utilisée.

Retours

Boolean

true si l’écouteur a été initialisé correctement ; false si un écouteur compatible existe déjà.

Exceptions

ArgumentNullException

Le paramètre connectionString est NULL.

InvalidOperationException

Le paramètre connectionString est le même qu'un appel précédent à cette méthode, mais les paramètres sont différents.

La méthode a été appelée à partir du CLR.

SecurityException

L'appelant n'a pas l'autorisation de sécurité d'accès du code SqlClientPermission requise.

SqlException

Un appel suivant à la méthode a été effectué à l'aide d'un paramètre connectionString équivalent mais avec un utilisateur différent, ou un utilisateur qui n'adopte pas par défaut le même schéma.

Également, toutes les exceptions SqlClient sous-jacentes.

Remarques

Cette méthode démarre l’écouteur pour recevoir des AppDomain notifications de dépendance à partir de la instance de SQL Server spécifiée par le connectionString paramètre . Cette méthode peut être appelée plusieurs fois avec différentes chaînes de connexion pour plusieurs serveurs.

Si aucun nom de file d’attente n’est spécifié, SqlDependency crée une file d’attente temporaire et un service dans le serveur qui est utilisé pour l’ensemble du processus, même si le processus implique plusieurs AppDomain. La file d’attente et le service sont automatiquement supprimés lors de l’arrêt de l’application.

Pour obtenir des remarques supplémentaires, consultez Start.

Voir aussi

S’applique à