SqlDependency.Start Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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
true
pokud se naslouchací proces inicializoval úspěšně; false
pokud již existuje kompatibilní naslouchací proces.
Výjimky
Parametr connectionString
má hodnotu NULL.
Parametr connectionString
je stejný jako předchozí volání této metody, ale parametry se liší.
Metoda byla volána z modulu CLR.
Volající nemá požadované SqlClientPermission oprávnění zabezpečení přístupu kódu (CAS).
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
true
pokud se naslouchací proces inicializoval úspěšně; false
pokud již existuje kompatibilní naslouchací proces.
Výjimky
Parametr connectionString
má hodnotu NULL.
Parametr connectionString
je stejný jako předchozí volání této metody, ale parametry se liší.
Metoda byla volána z modulu CLR.
Volající nemá požadované SqlClientPermission oprávnění zabezpečení přístupu kódu (CAS).
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.