Sdílet prostřednictvím


SqlDependency Třída

Definice

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
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.

Platí pro