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.

Pro nový vývoj použijte Microsoft. Data.SqlClient. Tato stránka dokumentuje System.Data.SqlClient.

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

Název	Description
SqlDependency()	Vytvoří novou instanci SqlDependency třídy s výchozím nastavením. Pro nový vývoj použijte Microsoft. Data.SqlClient. Tato stránka dokumentuje System.Data.SqlClient.
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. Pro nový vývoj použijte Microsoft. Data.SqlClient. Tato stránka dokumentuje System.Data.SqlClient.
SqlDependency(SqlCommand)	Vytvoří novou instanci SqlDependency třídy a přidruží ji k parametru SqlCommand . Pro nový vývoj použijte Microsoft. Data.SqlClient. Tato stránka dokumentuje System.Data.SqlClient.

Vlastnosti

Název	Description
HasChanges	Získá hodnotu, která označuje, zda se změnila jedna ze sad výsledků přidružených k závislosti. Pro nový vývoj použijte Microsoft. Data.SqlClient. Tato stránka dokumentuje System.Data.SqlClient.
Id	Získá hodnotu, která jedinečně identifikuje tuto instanci SqlDependency třídy. Pro nový vývoj použijte Microsoft. Data.SqlClient. Tato stránka dokumentuje System.Data.SqlClient.

Metody

Název	Description
AddCommandDependency(SqlCommand)	Přidruží SqlCommand objekt k této SqlDependency instanci. Pro nový vývoj použijte Microsoft. Data.SqlClient. Tato stránka dokumentuje System.Data.SqlClient.
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. Pro nový vývoj použijte Microsoft. Data.SqlClient. Tato stránka dokumentuje System.Data.SqlClient.
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. Pro nový vývoj použijte Microsoft. Data.SqlClient. Tato stránka dokumentuje System.Data.SqlClient.
Stop(String, String)	Zastaví naslouchací proces pro připojení zadané v předchozím Start volání. Pro nový vývoj použijte Microsoft. Data.SqlClient. Tato stránka dokumentuje System.Data.SqlClient.
Stop(String)	Zastaví naslouchací proces pro připojení zadané v předchozím Start volání. Pro nový vývoj použijte Microsoft. Data.SqlClient. Tato stránka dokumentuje System.Data.SqlClient.
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Událost

Název	Description
OnChange	Nastane při přijetí oznámení pro některý z příkazů přidružených k tomuto SqlDependency objektu. Pro nový vývoj použijte Microsoft. Data.SqlClient. Tato stránka dokumentuje System.Data.SqlClient.

Viz také

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