SqlDependency Třída

Definice

Obor názvů:

System.Data.SqlClient

Sestavení:

System.Data.dll

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 k příjmu 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 aplikace ASP.NET nebo služba střední vrstvy musí 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 opožadavch

Note

SqlDependency byl navržen tak, aby se používal ve službách ASP.NET nebo střední vrstvy, kde existuje relativně malý počet serverů, které mají vůči databázi aktivní závislosti. 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é při změně dat potřebujete spolehlivá oznámení s reakcí do jedné sekundy, projděte si části Plánování efektivní strategie oznámení dotazů a Alternativy k oznámením dotazů v článku Plánování oznámení.

Další informace najdete v tématu Dotazování v SQL Server a Nástrojová řešení oznámení.

Note

Událost OnChange může být generová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í seznam konkrétních požadavků.

Konstruktory

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

Vlastnosti

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

Metody

Name	Description
AddCommandDependency(SqlCommand)	Přidruží SqlCommand objekt k této SqlDependency instanci.
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetType()	Získá Type aktuální instance. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
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í řetězec pomocí zadané fronty SQL Server Service Broker.
Start(String)	Spustí naslouchací proces pro příjem oznámení o změnách závislostí z instance SQL Server určené připojovací řetězec.
Stop(String, String)	Zastaví naslouchací proces pro připojení zadané v předchozím Start volání.
Stop(String)	Zastaví naslouchací proces pro připojení zadané v předchozím Start volání.
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Událost

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

Viz také

• Použití notifikací dotazů
• Přehled ADO.NET