SqlDependency.Start Metoda

  • 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

Spustí naslouchací proces pro příjem oznámení o změnách závislostí.

Přetížení

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.

Poznámky

Naslouchací SqlDependency proces se restartuje, když dojde k chybě v připojení SQL Server.

Je možné provést více volání Start metody s následujícími omezeními:

  • Více volání se identickými parametry (stejné připojovací řetězec a přihlašovací údaje systému Windows ve volajícím vlákně) jsou platné.

  • Více volání s různými připojovacími řetězci je platné za předpokladu, že:

    • Každá připojovací řetězec určuje jinou databázi nebo

    • Každá připojovací řetězec určuje jiného uživatele, nebo

    • Volání pocházejí z různých domén aplikace.

Můžete správně SqlDependency pracovat pro aplikace, které používají více vláken k reprezentaci různých přihlašovacích údajů uživatele bez udělení role dbo skupině, protože různí uživatelé se mohou přihlásit k odběru a naslouchat (pomocí SqlCacheDependency nebo SqlCommand) frontě oznámení vytvořené správcem. Při spuštění příslušné domény aplikace volejte start s přihlašovacími údaji (Windows) uživatele, který má oprávnění k inicializaci služby nebo fronty (oprávnění CREATE QUEUE a CREATE SERVICE pro databázi). Ujistěte se, že se funkce Start volá jenom jednou pro každou doménu AppDomain, jinak se vyvolá výjimka nejednoznačnosti. Uživatelské vlákno musí mít oprávnění k přihlášení k odběru oznámení (oprávnění PŘIHLÁSIT SE K ODBĚRU OZNÁMENÍ DOTAZŮ pro databázi). SqlDependency přidruží žádost o předplatné uživatele bez oprávnění správce ke službě nebo frontě vytvořené správcem.

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.

public:
 static bool Start(System::String ^ connectionString);
public static bool Start (string connectionString);
static member Start : string -> bool
Public Shared Function Start (connectionString As String) As Boolean

Parametry

connectionString
String

Připojovací řetězec pro instanci SQL Server, ze kterého chcete získat oznámení o změnách.

Návraty

Boolean

true pokud se naslouchací proces inicializoval úspěšně; false pokud již existuje kompatibilní naslouchací proces.

Výjimky

ArgumentNullException

Parametr connectionString má hodnotu NULL.

InvalidOperationException

Parametr connectionString je stejný jako předchozí volání této metody, ale parametry se liší.

Metoda byla volána z modulu CLR.

SecurityException

Volající nemá požadované SqlClientPermission oprávnění zabezpečení přístupu kódu (CAS).

SqlException

Následné volání metody bylo provedeno s ekvivalentním connectionString parametrem s jiným uživatelem nebo uživatelem, který nemá výchozí stejné schéma.

Také všechny základní výjimky SqlClient .

Poznámky

Tato metoda spustí naslouchací proces pro AppDomain příjem oznámení o závislostech z instance SQL Server určené parametrem connectionString . Tato metoda může být volána více než jednou s různými připojovacími řetězci pro více serverů.

Další poznámky najdete v tématu Start.

Viz také

Platí pro

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.

public:
 static bool Start(System::String ^ connectionString, System::String ^ queue);
public static bool Start (string connectionString, string queue);
static member Start : string * string -> bool
Public Shared Function Start (connectionString As String, queue As String) As Boolean

Parametry

connectionString
String

Připojovací řetězec pro instanci SQL Server, ze kterého chcete získat oznámení o změnách.

queue
String

Existující SQL Server frontu služby Service Broker, která se má použít. Pokud null, použije se výchozí fronta.

Návraty

Boolean

true pokud se naslouchací proces inicializoval úspěšně; false pokud již existuje kompatibilní naslouchací proces.

Výjimky

ArgumentNullException

Parametr connectionString má hodnotu NULL.

InvalidOperationException

Parametr connectionString je stejný jako předchozí volání této metody, ale parametry se liší.

Metoda byla volána z modulu CLR.

SecurityException

Volající nemá požadované SqlClientPermission oprávnění zabezpečení přístupu kódu (CAS).

SqlException

Následné volání metody bylo provedeno s ekvivalentním connectionString parametrem, ale jiným uživatelem nebo uživatelem, který nemá výchozí stejné schéma.

Také všechny základní výjimky SqlClient .

Poznámky

Tato metoda spustí naslouchací proces pro AppDomain příjem oznámení o závislostech z instance SQL Server určené parametrem connectionString . Tato metoda může být volána více než jednou s různými připojovacími řetězci pro více serverů.

Pokud není zadán žádný název fronty, SqlDependency vytvoří se na serveru dočasná fronta a služba, která se používá pro celý proces, a to i v případě, že proces zahrnuje více než jeden AppDomain. Fronta a služba se při vypnutí aplikace automaticky odeberou.

Další poznámky najdete v tématu Start.

Viz také

Platí pro