SqlDependency Klasa
Definicja
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
-
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
Zobacz też
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla