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 .

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

Nazwa Opis
SqlDependency()

Tworzy nowe wystąpienie SqlDependency klasy z ustawieniami domyślnymi.
SqlDependency(SqlCommand, String, Int32)

Tworzy nowe wystąpienie SqlDependency klasy, kojarzy je z parametrem SqlCommand i określa opcje powiadomień oraz wartość limitu czasu.
SqlDependency(SqlCommand)

Tworzy nowe wystąpienie SqlDependency klasy i kojarzy je z parametrem SqlCommand .

Właściwości

Nazwa Opis
HasChanges

Pobiera wartość wskazującą, czy jeden z zestawów wyników skojarzonych z zależnością uległ zmianie.
Id

Pobiera wartość, która jednoznacznie identyfikuje to wystąpienie SqlDependency klasy.

Metody

Nazwa Opis
AddCommandDependency(SqlCommand)

Kojarzy obiekt z tym SqlDependency wystąpieniemSqlCommand.
Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.

(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.
Start(String)

Uruchamia odbiornik do odbierania powiadomień o zmianie zależności z wystąpienia SQL Server określonego przez parametry połączenia.
Stop(String, String)

Zatrzymuje odbiornik połączenia określonego w poprzednim Start wywołaniu.
Stop(String)

Zatrzymuje odbiornik połączenia określonego w poprzednim Start wywołaniu.
ToString()

Zwraca ciąg reprezentujący bieżący obiekt.

(Odziedziczone po Object)

Zdarzenia

Nazwa Opis
OnChange

Występuje, gdy zostanie odebrane powiadomienie dla dowolnego polecenia skojarzonego z tym SqlDependency obiektem.

Dotyczy

Zobacz też