SqlDependency Třída

Definice

Obor názvů:

Microsoft.Data.SqlClient

Sestavení:

Microsoft.Data.SqlClient.dll

Balíček:

Microsoft.Data.SqlClient v5.2.0

Objekt SqlDependency představuje závislost oznámení dotazu mezi aplikací a instancí SQL Server. Aplikace může vytvořit SqlDependency objekt a zaregistrovat se pro příjem oznámení prostřednictvím obslužné rutiny OnChangeEventHandler události.

public ref class SqlDependency sealed

public sealed class SqlDependency

type SqlDependency = class

Public NotInheritable Class SqlDependency

Dědičnost

Object

SqlDependency

Poznámky

SqlDependency je ideální pro scénáře ukládání do mezipaměti, kdy vaše ASP.NET aplikace nebo služba střední vrstvy potřebuje uchovávat určité informace uložené v mezipaměti. SqlDependency umožňuje přijímat oznámení, když se původní data v databázi změní, aby bylo možné mezipaměť aktualizovat.

Pokud chcete nastavit závislost, musíte objekt přidružit SqlDependency k jednomu nebo více SqlCommand objektům. Pokud chcete dostávat oznámení, musíte se přihlásit k odběru OnChange události. Další informace o požadavcích na vytváření dotazů na oznámení najdete v tématu Práce s oznámeními dotazů.

Poznámka

SqlDependency byla navržena pro použití ve službách ASP.NET nebo střední vrstvy, kde existuje relativně malý počet serverů se závislostmi aktivními vůči databázi. Nebyla navržena pro použití v klientských aplikacích, kde stovky nebo tisíce klientských počítačů měly SqlDependency objekty nastavené pro jeden databázový server. Pokud vyvíjíte aplikaci, ve které potřebujete spolehlivá oznámení v sekundách při změně dat, projděte si části Plánování efektivních oznámení dotazů a Alternativy k oznámením dotazů v článku Plánování oznámení .

Další informace najdete v tématech Oznámení dotazů v SQL Server a Řešení pro vytváření oznámení.

Poznámka

Událost OnChange může být vygenerována v jiném vlákně než vlákno, které iniciovalo spuštění příkazu.

Oznámení dotazů jsou podporována pouze pro příkazy SELECT, které splňují specifické požadavky.

Konstruktory

SqlDependency()	Vytvoří novou instanci SqlDependency třídy s výchozím nastavením.
SqlDependency(SqlCommand)	Vytvoří novou instanci třídy a přidruží SqlDependency ji k parametru SqlCommand .
SqlDependency(SqlCommand, String, Int32)	Vytvoří novou instanci třídy, přidruží SqlDependency ji k parametru SqlCommand a určí možnosti oznámení a hodnotu časového limitu.

Vlastnosti

HasChanges	Získá hodnotu, která označuje, zda se změnila jedna ze sad výsledků dotazu přidružené k závislosti.
Id	Získá hodnotu, která jednoznačně identifikuje tuto instanci SqlDependency třídy.

Metody

AddCommandDependency(SqlCommand)	Přidruží objekt k SqlCommand této SqlDependency instanci.
Start(String)	Spustí naslouchací proces pro příjem oznámení o změnách závislostí z instance SQL Server určené připojovacím řetězcem.
Start(String, String)	Spustí naslouchací proces pro příjem oznámení o změnách závislostí z instance SQL Server určené připojovacím řetězcem pomocí zadané SQL Server fronty služby Service Broker.
Stop(String)	Zastaví naslouchací proces pro připojení zadané v předchozím Start(String) volání.
Stop(String, String)	Zastaví naslouchací proces pro připojení zadané v předchozím Start(String, String) volání.

Událost

OnChange

Vyvolá se při přijetí oznámení pro některý z příkazů přidružených k tomuto SqlDependency objektu.