SqlDependency Klasa

Definicja

Przestrzeń nazw:

Microsoft.Data.SqlClient

Zestaw:

Microsoft.Data.SqlClient.dll

Pakiet:

Microsoft.Data.SqlClient v5.2.0

SqlDependency Obiekt reprezentuje zależność powiadomienia zapytania między aplikacją a wystąpieniem 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 Powiadomienia o zapytaniach w SQL Server i Kompilowanie 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.
Start(String)	Uruchamia odbiornik do 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 SQL Server Service Broker.
Stop(String)	Zatrzymuje odbiornik dla połączenia określonego w poprzednim Start(String) wywołaniu.
Stop(String, String)	Zatrzymuje odbiornik dla połączenia określonego w poprzednim Start(String, String) wywołaniu.

Zdarzenia

OnChange

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