SqlDependency.Start Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Uruchamia odbiornik do odbierania powiadomień o zmianie zależności.
Przeciążenia
Start(String) |
Uruchamia odbiornik odbierania powiadomień o zmianie zależności z wystąpienia SQL Server określonego przez parametry połączenia. |
Start(String, String) |
Uruchamia odbiornik do odbierania powiadomień o zmianie zależności z wystąpienia SQL Server określonego przez parametry połączenia przy użyciu określonej kolejki usługi Service Broker SQL Server. |
Uwagi
Odbiornik SqlDependency zostanie uruchomiony ponownie po wystąpieniu błędu w połączeniu SQL Server.
Można wykonać Start wiele wywołań metody, z zastrzeżeniem następujących ograniczeń:
Wiele wywołań z identycznymi parametrami (te same parametry połączenia i poświadczenia systemu Windows w wątku wywołującym) są prawidłowe.
Wiele wywołań z różnymi parametrami połączenia jest prawidłowych, o ile:
Każdy parametry połączenia określa inną bazę danych lub
Każdy parametry połączenia określa innego użytkownika lub
Wywołania pochodzą z różnych domen aplikacji.
Możesz zapewnić SqlDependency poprawną pracę dla aplikacji, które używają wielu wątków do reprezentowania różnych poświadczeń użytkownika bez nadawania roli dbo grupie, ponieważ różni użytkownicy mogą subskrybować i nasłuchiwać (przy użyciu lub SqlCacheDependencySqlCommand) do kolejki powiadomień utworzonej przez administratora. Po uruchomieniu odpowiedniej domeny aplikacji wywołaj metodę Rozpocznij od poświadczeń (Windows) użytkownika, który ma uprawnienia do inicjowania usługi/kolejki (uprawnienia CREATE QUEUE i CREATE SERVICE dla bazy danych). Upewnij się, że polecenie Start jest wywoływane tylko raz dla elementu AppDomain. W przeciwnym razie jest zgłaszany wyjątek niejednoznaczności. Wątek użytkownika musi mieć uprawnienia do subskrybowania powiadomienia (uprawnienie SUBSKRYBUJ POWIADOMIENIA ZAPYTANIA dla bazy danych). SqlDependency Spowoduje skojarzenie żądania subskrypcji użytkownika innego niż administrator z usługą/kolejką utworzoną przez administratora.
Start(String)
Uruchamia odbiornik odbierania powiadomień o zmianie zależności z wystąpienia SQL Server określonego przez parametry połączenia.
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
Parametry
- connectionString
- String
Parametry połączenia dla wystąpienia SQL Server, z którego mają być uzyskiwane powiadomienia o zmianie.
Zwraca
true
jeśli odbiornik został zainicjowany pomyślnie; false
jeśli zgodny odbiornik już istnieje.
Wyjątki
Parametr connectionString
ma wartość NULL.
Parametr connectionString
jest taki sam jak poprzednie wywołanie tej metody, ale parametry są różne.
Metoda została wywołana z poziomu środowiska CLR.
Obiekt wywołujący nie ma wymaganych SqlClientPermission uprawnień zabezpieczeń dostępu kodu (CAS).
Kolejne wywołanie metody zostało wykonane z równoważnym connectionString
parametrem z innym użytkownikiem lub użytkownikiem, który nie domyślnie używa tego samego schematu.
Ponadto wszystkie podstawowe wyjątki SqlClient .
Uwagi
Ta metoda uruchamia odbiornik dla AppDomain odbierania powiadomień zależności z wystąpienia SQL Server określonego connectionString
przez parametr . Ta metoda może być wywoływana więcej niż raz z różnymi parametrami połączenia dla wielu serwerów.
Aby uzyskać dodatkowe uwagi, zobacz Start.
Zobacz też
Dotyczy
Start(String, String)
Uruchamia odbiornik do odbierania powiadomień o zmianie zależności z wystąpienia SQL Server określonego przez parametry połączenia przy użyciu określonej kolejki usługi Service Broker 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 -> bool
Public Shared Function Start (connectionString As String, queue As String) As Boolean
Parametry
- connectionString
- String
Parametry połączenia dla wystąpienia SQL Server, z którego mają być uzyskiwane powiadomienia o zmianie.
- queue
- String
Istniejąca kolejka usługi Service Broker SQL Server do użycia. Jeśli null
jest używana kolejka domyślna.
Zwraca
true
jeśli odbiornik został zainicjowany pomyślnie; false
jeśli zgodny odbiornik już istnieje.
Wyjątki
Parametr connectionString
ma wartość NULL.
Parametr connectionString
jest taki sam jak poprzednie wywołanie tej metody, ale parametry są różne.
Metoda została wywołana z poziomu środowiska CLR.
Obiekt wywołujący nie ma wymaganych SqlClientPermission uprawnień zabezpieczeń dostępu kodu (CAS).
Kolejne wywołanie metody zostało wykonane z równoważnym connectionString
parametrem, ale innym użytkownikiem lub użytkownikiem, który nie domyślnie używa tego samego schematu.
Ponadto wszystkie podstawowe wyjątki SqlClient .
Uwagi
Ta metoda uruchamia odbiornik dla AppDomain odbierania powiadomień zależności z wystąpienia SQL Server określonego connectionString
przez parametr . Ta metoda może być wywoływana więcej niż raz z różnymi parametrami połączenia dla wielu serwerów.
Jeśli nie określono nazwy kolejki, SqlDependency tworzy tymczasową kolejkę i usługę na serwerze, który jest używany dla całego procesu, nawet jeśli proces obejmuje więcej niż jedną AppDomain. Kolejka i usługa są automatycznie usuwane po zamknięciu aplikacji.
Aby uzyskać dodatkowe uwagi, zobacz Start.