Udostępnij za pośrednictwem


SqlDependency.Start Metoda

Definicja

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 nulljest 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.

Zobacz też

Dotyczy