Udostępnij za pośrednictwem

SqlDependency Klasa

  • Odwołanie

Definicja

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

Obiekt SqlDependency reprezentuje zależność powiadomienia zapytania między aplikacją a wystąpieniem programu SQL Server. Aplikacja może utworzyć SqlDependency obiekt i zarejestrować się w celu otrzymywania powiadomień 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 przypadku scenariuszy 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 SqlCommand jednym obiektem. Aby otrzymywać powiadomienia, musisz zasubskrybować OnChange zdarzenie. Aby uzyskać więcej informacji na temat wymagań dotyczących tworzenia zapytań dotyczących powiadomień, zobacz Praca z powiadomieniami zapytań.

Uwaga

SqlDependency został zaprojektowany tak, aby był używany w usługach ASP.NET lub warstwie środkowej, w których istnieje stosunkowo niewielka liczba serwerów, które mają aktywne zależności względem bazy danych. Nie został zaprojektowany do użytku w aplikacjach klienckich, gdzie 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 wysyłania powiadomień o zapytaniach i alternatywami dla powiadomień w artykule Planowanie powiadomień.

Aby uzyskać więcej informacji, zobacz Artykuł Query Notifications in SQL Server and Building Notification Solutions (Powiadomienia o zapytaniach w programie SQL Server ) i Building Notification Solutions (Tworzenie rozwiązań powiadomień).

Uwaga

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

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

Konstruktory

SqlDependency()

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

Tworzy nowe wystąpienie SqlDependency klasy i kojarzy je z parametrem SqlCommand .
SqlDependency(SqlCommand, String, Int32)

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

Właściwości

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

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()

Type Pobiera bieżące wystąpienie.

(Odziedziczone po Object)
MemberwiseClone()

Tworzy płytkią kopię bieżącego Objectelementu .

(Odziedziczone po Object)
Start(String)

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

Uruchamia odbiornik do odbierania powiadomień o zmianie zależności z wystąpienia programu SQL Server określonego przez parametry połączenia przy użyciu określonej kolejki usługi SQL Server Service Broker.
Stop(String)

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

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

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

(Odziedziczone po Object)

Zdarzenia

OnChange

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

Dotyczy

Zobacz też