SqlDependency Třída

  • Reference

Definice

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

Objekt SqlDependency představuje závislost oznámení dotazu mezi aplikací a instancí SQL Serveru. 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 musí uchovávat určité informace 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ů pro oznámení najdete v tématu Práce s oznámeními dotazů.

Poznámka

SqlDependency byl navržen pro použití ve službách ASP.NET nebo střední vrstvy, kde je relativně malý počet serverů, které mají aktivní závislosti na databázi. Nebyl navržen 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 dílčí sekundě při změně dat, přečtě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ů na SQL Serveru a Řešení pro vytváření oznámení.

Poznámka

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í 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ů přidružených 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()

Získá aktuální Type instanci.

(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 Serveru 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 Serveru určené připojovacím řetězcem 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

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

Platí pro

Viz také