SqlDependency Třída

  • Reference

Definice

Obor názvů:
System.Data.SqlClient
Sestavení:
System.Data.SqlClient.dll
Sestavení:
System.Data.dll
Balíček:
System.Data.SqlClient v4.8.6

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.
Equals(Object)

Určí, zda se zadaný objekt rovná aktuálnímu objektu.

(Zděděno od Object)
GetHashCode()

Slouží jako výchozí hashovací funkce.

(Zděděno od Object)
GetType()

Type Získá z aktuální instance.

(Zděděno od Object)
MemberwiseClone()

Vytvoří mělkou kopii aktuálního Objectsouboru .

(Zděděno od Object)
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.
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 služby SQL Server Service Broker.
Stop(String)

Zastaví naslouchací proces pro připojení zadané v předchozím Start volání.
Stop(String, 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

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

Viz také