SqlDependency.Start Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Data.SqlClient
Zestaw:
System.Data.SqlClient.dll
Zestaw:
System.Data.dll
Pakiet:
System.Data.SqlClient v4.8.6

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

Boolean

true jeśli odbiornik został zainicjowany pomyślnie; false jeśli zgodny odbiornik już istnieje.

Wyjątki

ArgumentNullException

Parametr connectionString ma wartość NULL.

InvalidOperationException

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.

SecurityException

Obiekt wywołujący nie ma wymaganych SqlClientPermission uprawnień zabezpieczeń dostępu kodu (CAS).

SqlException

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 nulljest używana kolejka domyślna.

Zwraca

Boolean

true jeśli odbiornik został zainicjowany pomyślnie; false jeśli zgodny odbiornik już istnieje.

Wyjątki

ArgumentNullException

Parametr connectionString ma wartość NULL.

InvalidOperationException

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.

SecurityException

Obiekt wywołujący nie ma wymaganych SqlClientPermission uprawnień zabezpieczeń dostępu kodu (CAS).

SqlException

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.

Zobacz też

Dotyczy