SqlDependency.Start Méthode
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.
Démarre l’écouteur pour recevoir des notifications de modification de dépendance.
Surcharges
| Nom | Description |
|---|---|
| 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. |
| 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. |
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 Windows informations d’identification 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 rendre le SqlDependency travail correct pour les 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) à une file d’attente de notification 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 autorisé à initialiser un service/file d’attente (la file d’attente CREATE et les autorisations 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 de SQL Server spécifiée par le chaîne de connexion.
public:
static bool Start(System::String ^ connectionString);public static bool Start(string connectionString);static member Start : string -> boolPublic Shared Function Start (connectionString As String) As BooleanParamètres
- connectionString
- String
Connection string pour l’instance de SQL Server à partir de laquelle obtenir des notifications de modification.
Retours
true si l’écouteur a été initialisé avec succès ; false si un écouteur compatible existe déjà.
Exceptions
Le connectionString paramètre est NULL.
Le connectionString paramètre est identique à 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.
L’appelant n’a pas l’autorisation de sécurité d’accès au code (CAS) requise SqlClientPermission .
Un appel ultérieur à la méthode a été effectué avec un paramètre équivalent connectionString avec un autre utilisateur ou un utilisateur qui n’est pas défini par défaut sur le même schéma.
En outre, toutes les exceptions SqlClient sous-jacentes.
Remarques
Cette méthode démarre l’écouteur de l'AppDomain pour recevoir des notifications de dépendance à partir de l’instance de SQL Server spécifiée par le paramètre connectionString. Cette méthode peut être appelée plusieurs fois avec des chaînes de connexion différentes 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 à 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.
public:
static bool Start(System::String ^ connectionString, System::String ^ queue);public static bool Start(string connectionString, string queue);static member Start : string * string -> boolPublic Shared Function Start (connectionString As String, queue As String) As BooleanParamètres
- connectionString
- String
Connection string pour l’instance de SQL Server à partir de laquelle obtenir des notifications de modification.
- queue
- String
File d’attente Service Broker existante SQL Server à utiliser. Si null, la file d’attente par défaut est utilisée.
Retours
true si l’écouteur a été initialisé avec succès ; false si un écouteur compatible existe déjà.
Exceptions
Le connectionString paramètre est NULL.
Le connectionString paramètre est identique à 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.
L’appelant n’a pas l’autorisation de sécurité d’accès au code (CAS) requise SqlClientPermission .
Un appel ultérieur à la méthode a été effectué avec un paramètre équivalent connectionString , mais un autre utilisateur, ou un utilisateur qui n’a pas par défaut le même schéma.
En outre, toutes les exceptions SqlClient sous-jacentes.
Remarques
Cette méthode démarre l’écouteur de l'AppDomain pour recevoir des notifications de dépendance à partir de l’instance de SQL Server spécifiée par le paramètre connectionString. Cette méthode peut être appelée plusieurs fois avec des chaînes de connexion différentes 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 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.
