SqlDependency Osztály

Definíció

Névtér:
System.Data.SqlClient
Szerelvény:
System.Data.dll
Forrás:
System.Data.SqlClient.notsupported.cs

A SqlDependency objektum egy alkalmazás és egy SQL Server példány közötti lekérdezésértesítési függőséget jelöl. Az alkalmazások létrehozhatnak egy SqlDependency objektumot, és regisztrálhatnak, hogy értesítéseket kapjanak az OnChangeEventHandler eseménykezelőn keresztül.

public ref class SqlDependency sealed
public sealed class SqlDependency
type SqlDependency = class
Public NotInheritable Class SqlDependency
Öröklődés
Object
SqlDependency

Megjegyzések

SqlDependency ideális gyorsítótárazási forgatókönyvekhez, ahol a ASP.NET alkalmazásnak vagy a középső rétegbeli szolgáltatásnak bizonyos adatokat gyorsítótárazottnak kell tárolnia a memóriában. SqlDependency lehetővé teszi az értesítések fogadását, amikor az adatbázis eredeti adatai megváltoznak, hogy a gyorsítótár frissíthető legyen.

A függőség beállításához egy objektumot SqlDependency egy vagy több SqlCommand objektumhoz kell társítania. Az értesítések fogadásához elő kell fizetnie az OnChange eseményre. Az értesítések lekérdezéseinek létrehozásával kapcsolatos követelményekről további információt a Lekérdezésértesítések használata című témakörben talál.

Note

SqlDependency ASP.NET vagy középszintű szolgáltatásokban való használatra tervezték, ahol viszonylag kevés olyan kiszolgáló van, amely az adatbázissal szemben aktív függőségekkel rendelkezik. Nem ügyfélalkalmazásokhoz tervezték, ahol több száz vagy több ezer ügyfélszámítógépen egyetlen SqlDependency adatbázis-kiszolgálóhoz állítottak be objektumokat. Ha olyan alkalmazást fejleszt, amelynek adatváltozások esetén megbízható másodlagos értesítésekre van szüksége, tekintse át a Hatékony lekérdezésértesítési stratégia tervezése és a lekérdezési értesítések alternatívái című szakaszt az Értesítések tervezése című cikkben.

További információ: .Lekérdezési értesítések a SQL Server és Építési értesítési megoldásokban.

Note

Előfordulhat, hogy az OnChange esemény a parancs végrehajtását kezdeményező száltól eltérő szálon jön létre.

A lekérdezési értesítések csak olyan SELECT-utasítások esetében támogatottak, amelyek megfelelnek az adott követelmények listájának.

Konstruktorok

Name Description
SqlDependency()

Létrehozza az osztály új példányát az SqlDependency alapértelmezett beállításokkal.
SqlDependency(SqlCommand, String, Int32)

Létrehozza az SqlDependency osztály új példányát, társítja a SqlCommand paraméterrel, és megadja az értesítési beállításokat és egy időtúllépési értéket.
SqlDependency(SqlCommand)

Létrehozza az SqlDependency osztály új példányát, és társítja a SqlCommand paraméterrel.

Tulajdonságok

Name Description
HasChanges

Olyan értéket kap, amely jelzi, hogy a függőséghez társított eredményhalmazok egyike módosult-e.
Id

Olyan értéket kap, amely egyedileg azonosítja az osztály ezen példányát SqlDependency .

Metódusok

Name Description
AddCommandDependency(SqlCommand)

Objektum társítása SqlCommand ehhez a SqlDependency példányhoz.
Equals(Object)

Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal.

(Öröklődés forrása Object)
GetHashCode()

Ez az alapértelmezett kivonatoló függvény.

(Öröklődés forrása Object)
GetType()

Lekéri az Type aktuális példányt.

(Öröklődés forrása Object)
MemberwiseClone()

Az aktuális Objectpéldány sekély másolatát hozza létre.

(Öröklődés forrása Object)
Start(String, String)

Elindítja a figyelőt a függőségmódosítási értesítések fogadásához a kapcsolati karakterlánc által megadott SQL Server példánytól a megadott SQL Server Service Broker-üzenetsor használatával.
Start(String)

Elindítja a figyelőt a függőségváltozásról a kapcsolati karakterlánc által megadott SQL Server példányától.
Stop(String, String)

Az előző Start hívásban megadott kapcsolat figyelőjének leállítása.
Stop(String)

Az előző Start hívásban megadott kapcsolat figyelőjének leállítása.
ToString()

Az aktuális objektumot jelképező sztringet ad vissza.

(Öröklődés forrása Object)

esemény

Name Description
OnChange

Ez akkor fordul elő, ha az objektumhoz SqlDependency társított parancsok bármelyikéről értesítést kap.

A következőre érvényes:

Lásd még