SqlDependency Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.Data.SqlClient

Zestaw:: System.Data.SqlClient.dll

Zestaw:: System.Data.dll

Pakiet:: System.Data.SqlClient v4.8.6

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Obiekt SqlDependency reprezentuje zależność powiadomienia zapytania między aplikacją a wystąpieniem SQL Server. Aplikacja może utworzyć SqlDependency obiekt i zarejestrować się w celu odbierania 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 w pamięci podręcznej. 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 o zapytaniach.

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 mających aktywne zależności względem bazy danych. Nie została ona zaprojektowana 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 po zmianie 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 (Powiadomienia o zapytaniach w usłudze SQL Server) i Building Notification Solutions (Tworzenie rozwiązań do powiadomień).

Uwaga

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 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 parametrem SqlCommand 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 wartość bieżącego wystąpienia. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
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.
Stop(String)	Zatrzymuje odbiornik połączenia określonego w poprzednim Start wywołaniu.
Stop(String, 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

OnChange

Występuje po odebraniu powiadomienia dla dowolnego polecenia skojarzonego z tym SqlDependency obiektem.

Dotyczy