SqlDependency Klasa

Definicja

Przestrzeń nazw:

System.Data.SqlClient

Zestaw:

System.Data.dll

Obiekt SqlDependency reprezentuje zależność powiadomienia zapytania między aplikacją a wystąpieniem SQL Server. Aplikacja może utworzyć SqlDependency obiekt i zarejestrować się, aby otrzymywać powiadomienia za pośrednictwem programu obsługi zdarzeń OnChangeEventHandler .

W przypadku nowego programowania użyj Microsoft. Data.SqlClient. Ta strona zawiera dokumenty System.Data.SqlClient.

public ref class SqlDependency sealed

public sealed class SqlDependency

type SqlDependency = class

Public NotInheritable Class SqlDependency

Dziedziczenie

Object

SqlDependency

Uwagi

SqlDependency jest idealnym rozwiązaniem w scenariuszach buforowania, w których aplikacja ASP.NET lub usługa warstwy środkowej musi przechowywać pewne informacje buforowane w pamięci. SqlDependency umożliwia odbieranie powiadomień, gdy oryginalne dane w bazie danych zmienią się, aby można było odświeżyć pamięć podręczną.

Aby skonfigurować zależność, należy skojarzyć SqlDependency obiekt z co najmniej jednym SqlCommand obiektem. Aby otrzymywać powiadomienia, musisz subskrybować OnChange zdarzenie. Aby uzyskać więcej informacji na temat wymagań dotyczących tworzenia zapytań dotyczących powiadomień, zobacz Praca z powiadomieniami zapytań.

Note

SqlDependency został zaprojektowany tak, aby był używany w usługach ASP.NET lub warstwie środkowej, gdzie istnieje stosunkowo mała liczba serwerów mających aktywne zależności względem bazy danych. Nie został zaprojektowany do użytku w aplikacjach klienckich, w których setki lub tysiące komputerów klienckich miałyby SqlDependency obiekty skonfigurowane dla jednego serwera bazy danych. Jeśli tworzysz aplikację, w której potrzebujesz niezawodnych powiadomień podrzędnych w przypadku zmian danych, zapoznaj się z sekcjami Planowanie strategii efektywnego powiadamiania o zapytaniach i alternatywami dla powiadomień zapytań w artykule Planowanie powiadomień .

Aby uzyskać więcej informacji, zobacz Query Notifications in SQL Server and Building Notification Solutions.

Note

Zdarzenie OnChange może być generowane w innym wątku niż wątek, który zainicjował wykonywanie polecenia.

Powiadomienia o zapytaniach są obsługiwane tylko w przypadku instrukcji SELECT, które spełniają listę określonych wymagań.

Konstruktory

Nazwisko	Opis
SqlDependency()	Tworzy nowe wystąpienie SqlDependency klasy z ustawieniami domyślnymi. W przypadku nowego programowania użyj Microsoft. Data.SqlClient. Ta strona zawiera dokumenty System.Data.SqlClient.
SqlDependency(SqlCommand, String, Int32)	Tworzy nowe wystąpienie SqlDependency klasy, kojarzy je z parametrem SqlCommand i określa opcje powiadomień oraz wartość limitu czasu. W przypadku nowego programowania użyj Microsoft. Data.SqlClient. Ta strona zawiera dokumenty System.Data.SqlClient.
SqlDependency(SqlCommand)	Tworzy nowe wystąpienie SqlDependency klasy i kojarzy je z parametrem SqlCommand . W przypadku nowego programowania użyj Microsoft. Data.SqlClient. Ta strona zawiera dokumenty System.Data.SqlClient.

Właściwości

Nazwisko	Opis
HasChanges	Pobiera wartość wskazującą, czy jeden z zestawów wyników skojarzonych z zależnością uległ zmianie. W przypadku nowego programowania użyj Microsoft. Data.SqlClient. Ta strona zawiera dokumenty System.Data.SqlClient.
Id	Pobiera wartość, która jednoznacznie identyfikuje to wystąpienie SqlDependency klasy. W przypadku nowego programowania użyj Microsoft. Data.SqlClient. Ta strona zawiera dokumenty System.Data.SqlClient.

Metody

Nazwisko	Opis
AddCommandDependency(SqlCommand)	Kojarzy obiekt z tym SqlCommand wystąpieniemSqlDependency. W przypadku nowego programowania użyj Microsoft. Data.SqlClient. Ta strona zawiera dokumenty System.Data.SqlClient.
Equals(Object)	Określa, czy określony obiekt jest równy bieżącemu obiektowi. (Odziedziczone po Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Pobiera Type bieżącego wystąpienia. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Object. (Odziedziczone po Object)
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 SQL Server Service Broker. W przypadku nowego programowania użyj Microsoft. Data.SqlClient. Ta strona zawiera dokumenty System.Data.SqlClient.
Start(String)	Uruchamia odbiornik do odbierania powiadomień o zmianie zależności z wystąpienia SQL Server określonego przez parametry połączenia. W przypadku nowego programowania użyj Microsoft. Data.SqlClient. Ta strona zawiera dokumenty System.Data.SqlClient.
Stop(String, String)	Zatrzymuje odbiornik połączenia określonego w poprzednim Start wywołaniu. W przypadku nowego programowania użyj Microsoft. Data.SqlClient. Ta strona zawiera dokumenty System.Data.SqlClient.
Stop(String)	Zatrzymuje odbiornik połączenia określonego w poprzednim Start wywołaniu. W przypadku nowego programowania użyj Microsoft. Data.SqlClient. Ta strona zawiera dokumenty System.Data.SqlClient.
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Zdarzenia

Nazwisko	Opis
OnChange	Występuje, gdy zostanie odebrane powiadomienie dla dowolnego polecenia skojarzonego z tym SqlDependency obiektem. W przypadku nowego programowania użyj Microsoft. Data.SqlClient. Ta strona zawiera dokumenty System.Data.SqlClient.

Zobacz też

• Korzystanie z powiadomień o zapytaniach
• Omówienie ADO.NET