SqlDependency.Start Metódus
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
Elindítja a figyelőt a függőségmódosítási értesítések fogadásához.
Túlterhelések
| Name | Description |
|---|---|
| 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. |
| 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. |
Megjegyzések
A SqlDependency figyelő újraindul, amikor hiba történik a SQL Server kapcsolatban.
A metódushoz Start több hívás is indítható, az alábbi korlátozásokra is figyelemmel:
Több azonos paraméterrel rendelkező hívás (ugyanaz a kapcsolati karakterlánc és Windows hitelesítő adatok a hívásláncban) érvényes.
A különböző kapcsolati sztringekkel rendelkező hívások mindaddig érvényesek, amíg:
Minden kapcsolati karakterlánc egy másik adatbázist határoz meg, vagy
Minden kapcsolati karakterlánc egy másik felhasználót határoz meg, vagy
A hívások különböző alkalmazástartományokból származnak.
A több szálat használó alkalmazások helyesen végezhetik el a SqlDependency munkát a különböző felhasználói hitelesítő adatok megjelenítéséhez anélkül, hogy a dbo szerepkört a csoportnak adnák, mivel a különböző felhasználók előfizethetnek és meghallgathatják a rendszergazda által létrehozott értesítési üzenetsort (a használatával vagy SqlCacheDependencyhasználatávalSqlCommand). A megfelelő alkalmazástartomány indításakor hívja meg a Start parancsot egy szolgáltatás/üzenetsor inicializálására engedéllyel rendelkező felhasználó (Windows) hitelesítő adataival (a CREATE QUEUE és a CREATE SERVICE engedélyekkel az adatbázishoz). Győződjön meg arról, hogy a Start csak appDomainenként egyszer van meghívva, ellenkező esetben kétértelmű kivétel keletkezik. A felhasználói szálnak rendelkeznie kell engedéllyel az értesítésre való feliratkozáshoz (az adatbázis FELIRATKOZÁSI LEKÉRDEZÉSI ÉRTESÍTÉSEK engedélyével). SqlDependency egy nem rendszergazdai felhasználó előfizetési kérését a rendszergazda által létrehozott szolgáltatáshoz/üzenetsorhoz társítja.
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.
public:
static bool Start(System::String ^ connectionString);public static bool Start(string connectionString);static member Start : string -> boolPublic Shared Function Start (connectionString As String) As BooleanParaméterek
- connectionString
- String
Azon SQL Server példányának kapcsolati karakterlánc, amelyről változásértesítéseket kérhet le.
Válaszok
true ha a figyelő inicializálása sikeresen megtörtént; false ha már létezik kompatibilis figyelő.
Kivételek
A connectionString paraméter null értékű.
A connectionString paraméter megegyezik a metódus korábbi hívásával, de a paraméterek eltérőek.
A metódus meghívása a CLR-ben történt.
A hívó nem rendelkezik a szükséges SqlClientPermission kódhozzáférés-biztonsági (CAS) engedéllyel.
A metódust egy másik felhasználóval egyenértékű connectionString paraméterrel vagy olyan felhasználóval hívták meg, aki nem alapértelmezetten ugyanazt a sémát használja.
Emellett minden mögöttes SqlClient-kivételt is.
Megjegyzések
Ez a metódus elindítja a AppDomain figyelőt a függőségi értesítések fogadásához a connectionString paraméter által megadott SQL Server példányától. Ezt a metódust többször is meghívhatja több kiszolgáló különböző kapcsolati sztringjeivel.
További megjegyzésekért lásd: Start.
Lásd még
A következőre érvényes:
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.
public:
static bool Start(System::String ^ connectionString, System::String ^ queue);public static bool Start(string connectionString, string queue);static member Start : string * string -> boolPublic Shared Function Start (connectionString As String, queue As String) As BooleanParaméterek
- connectionString
- String
Azon SQL Server példányának kapcsolati karakterlánc, amelyről változásértesítéseket kérhet le.
- queue
- String
Egy meglévő SQL Server Service Broker-üzenetsort kell használni. Ha nullaz alapértelmezett üzenetsort használja a rendszer.
Válaszok
true ha a figyelő inicializálása sikeresen megtörtént; false ha már létezik kompatibilis figyelő.
Kivételek
A connectionString paraméter null értékű.
A connectionString paraméter megegyezik a metódus korábbi hívásával, de a paraméterek eltérőek.
A metódus meghívása a CLR-ben történt.
A hívó nem rendelkezik a szükséges SqlClientPermission kódhozzáférés-biztonsági (CAS) engedéllyel.
A metódus későbbi hívása egy egyenértékű connectionString paraméterrel történt, de egy másik felhasználóval, vagy egy olyan felhasználóval, aki nem alapértelmezetten ugyanazt a sémát használja.
Emellett minden mögöttes SqlClient-kivételt is.
Megjegyzések
Ez a metódus elindítja a AppDomain figyelőt a függőségi értesítések fogadásához a connectionString paraméter által megadott SQL Server példányától. Ezt a metódust többször is meghívhatja több kiszolgáló különböző kapcsolati sztringjeivel.
Ha nincs megadva üzenetsor neve, SqlDependency létrehoz egy ideiglenes üzenetsort és szolgáltatást a kiszolgálón, amelyet a teljes folyamathoz használnak, még akkor is, ha a folyamat több eggyel AppDomainis jár. Az alkalmazás leállításakor a rendszer automatikusan eltávolítja az üzenetsort és a szolgáltatást.
További megjegyzésekért lásd: Start.
