SqlDependency.Start Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Startet den Listener für den Empfang von Abhängigkeitsänderungsbenachrichtigungen.
Überlädt
| Name | Beschreibung |
|---|---|
| Start(String) |
Startet den Listener für den Empfang von Abhängigkeitsänderungsbenachrichtigungen aus der Instanz von SQL Server, die durch die Verbindungszeichenfolge angegeben wurde. |
| Start(String, String) |
Startet den Listener für den Empfang von Abhängigkeitsänderungsbenachrichtigungen aus der Instanz von SQL Server, die vom Verbindungszeichenfolge mithilfe der angegebenen SQL Server Service Broker-Warteschlange angegeben wurde. |
Hinweise
Der SqlDependency Listener wird neu gestartet, wenn in der SQL Server Verbindung ein Fehler auftritt.
Es können mehrere Aufrufe an die Start Methode durchgeführt werden, vorbehaltlich der folgenden Einschränkungen:
Mehrere Aufrufe mit identischen Parametern (dasselbe Verbindungszeichenfolge und Windows Anmeldeinformationen im aufrufenden Thread) sind gültig.
Mehrere Aufrufe mit unterschiedlichen Verbindungszeichenfolgen sind gültig, solange:
Jede Verbindungszeichenfolge gibt eine andere Datenbank an oder
Jede Verbindungszeichenfolge gibt einen anderen Benutzer an oder
Die Aufrufe stammen aus verschiedenen Anwendungsdomänen.
Sie können die SqlDependency Arbeit für Anwendungen, die mehrere Threads verwenden, um verschiedene Benutzeranmeldeinformationen darzustellen, ohne der Gruppe die Dbo-Rolle zuzuweisen, da verschiedene Benutzer eine Benachrichtigungswarteschlange abonnieren und überwachen können , SqlCacheDependencySqlCommanddie von einem Administrator erstellt wurde. Wenn die relevante Anwendungsdomäne gestartet wird, rufen Sie "Start" mit den Anmeldeinformationen (Windows) eines Benutzers auf, der über die Berechtigung zum Initialisieren eines Diensts/einer Warteschlange verfügt (die CREATE QUEUE- und CREATE SERVICE-Berechtigungen für die Datenbank). Stellen Sie sicher, dass "Start" nur einmal pro AppDomain aufgerufen wird, andernfalls wird eine Mehrdeutigkeits ausnahme ausgelöst. Der Benutzerthread muss über die Berechtigung zum Abonnieren der Benachrichtigung verfügen (die Berechtigung SUBSCRIBE QUERY NOTIFICATIONS für die Datenbank). SqlDependency ordnet die Abonnementanforderung eines Nicht-Administratorbenutzers dem vom Administrator erstellten Dienst/der Warteschlange zu.
Start(String)
Startet den Listener für den Empfang von Abhängigkeitsänderungsbenachrichtigungen aus der Instanz von SQL Server, die durch die Verbindungszeichenfolge angegeben wurde.
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 BooleanParameter
- connectionString
- String
Die Verbindungszeichenfolge für die Instanz von SQL Server, aus der Änderungsbenachrichtigungen abgerufen werden sollen.
Gibt zurück
true wenn der Listener erfolgreich initialisiert wurde; false wenn bereits ein kompatibler Listener vorhanden ist.
Ausnahmen
Der connectionString Parameter ist NULL.
Der connectionString Parameter ist identisch mit einem vorherigen Aufruf dieser Methode, die Parameter sind jedoch unterschiedlich.
Die Methode wurde innerhalb der CLR aufgerufen.
Der Aufrufer verfügt nicht über die erforderliche SqlClientPermission Cas-Berechtigung (Code Access Security).
Ein anschließender Aufruf der Methode wurde mit einem entsprechenden connectionString Parameter mit einem anderen Benutzer oder einem Benutzer durchgeführt, der nicht standardmäßig dasselbe Schema aufweist.
Außerdem werden alle zugrunde liegenden SqlClient-Ausnahmen ausgeführt.
Hinweise
Diese Methode startet den Listener für die AppDomain für den Empfang von Abhängigkeitsbenachrichtigungen aus der Instanz von SQL Server, die durch den Parameter connectionString angegeben wird. Diese Methode kann mehrmals mit unterschiedlichen Verbindungszeichenfolgen für mehrere Server aufgerufen werden.
Weitere Hinweise finden Sie unter Start.
Weitere Informationen
Gilt für:
Start(String, String)
Startet den Listener für den Empfang von Abhängigkeitsänderungsbenachrichtigungen aus der Instanz von SQL Server, die vom Verbindungszeichenfolge mithilfe der angegebenen SQL Server Service Broker-Warteschlange angegeben wurde.
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 BooleanParameter
- connectionString
- String
Die Verbindungszeichenfolge für die Instanz von SQL Server, aus der Änderungsbenachrichtigungen abgerufen werden sollen.
- queue
- String
Eine vorhandene SQL Server Service Broker-Warteschlange, die verwendet werden soll. Wenn nulldie Standardwarteschlange verwendet wird.
Gibt zurück
true wenn der Listener erfolgreich initialisiert wurde; false wenn bereits ein kompatibler Listener vorhanden ist.
Ausnahmen
Der connectionString Parameter ist NULL.
Der connectionString Parameter ist identisch mit einem vorherigen Aufruf dieser Methode, die Parameter sind jedoch unterschiedlich.
Die Methode wurde innerhalb der CLR aufgerufen.
Der Aufrufer verfügt nicht über die erforderliche SqlClientPermission Cas-Berechtigung (Code Access Security).
Ein anschließender Aufruf der Methode wurde mit einem entsprechenden connectionString Parameter, aber einem anderen Benutzer oder einem Benutzer vorgenommen, der nicht standardmäßig dasselbe Schema aufweist.
Außerdem werden alle zugrunde liegenden SqlClient-Ausnahmen ausgeführt.
Hinweise
Diese Methode startet den Listener für die AppDomain für den Empfang von Abhängigkeitsbenachrichtigungen aus der Instanz von SQL Server, die durch den Parameter connectionString angegeben wird. Diese Methode kann mehrmals mit unterschiedlichen Verbindungszeichenfolgen für mehrere Server aufgerufen werden.
Wenn kein Warteschlangenname angegeben ist, SqlDependency wird eine temporäre Warteschlange und ein Temporärer Dienst auf dem Server erstellt, der für den gesamten Prozess verwendet wird, auch wenn der Prozess mehrere AppDomainumfasst. Die Warteschlange und der Dienst werden beim Herunterfahren der Anwendung automatisch entfernt.
Weitere Hinweise finden Sie unter Start.