SqlDependency.Start Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Avvia il listener per ricevere notifiche di modifica delle dipendenze.
Overload
| Nome | Descrizione |
|---|---|
| Start(String) |
Avvia il listener per ricevere notifiche di modifica delle dipendenze dall'istanza di SQL Server specificata dal stringa di connessione. |
| Start(String, String) |
Avvia il listener per ricevere notifiche di modifica delle dipendenze dall'istanza di SQL Server specificata dal stringa di connessione usando la coda di Service Broker SQL Server specificata. |
Commenti
Il listener SqlDependency verrà riavviato quando si verifica un errore nella connessione SQL Server.
È possibile effettuare più chiamate al Start metodo, soggette alle restrizioni seguenti:
Più chiamate con parametri identici (le stesse stringa di connessione e le credenziali Windows nel thread chiamante) sono valide.
Più chiamate con stringhe di connessione diverse sono valide purché:
Ogni stringa di connessione specifica un database diverso o
Ogni stringa di connessione specifica un utente diverso o
Le chiamate provengono da domini applicazione diversi.
È possibile eseguire correttamente il SqlDependency funzionamento per le applicazioni che usano più thread per rappresentare credenziali utente diverse senza assegnare il ruolo dbo al gruppo, perché diversi utenti possono sottoscrivere e ascoltare (usando SqlCacheDependency o SqlCommand) una coda di notifica creata da un amministratore. All'avvio del dominio applicazione pertinente, chiamare Inizia con le credenziali (Windows) di un utente che dispone dell'autorizzazione per inizializzare un servizio o una coda (le autorizzazioni CREATE QUEUE e CREATE SERVICE per il database). Assicurarsi che Start venga chiamato una sola volta per AppDomain. In caso contrario, viene generata un'eccezione di ambiguità. Il thread utente deve disporre dell'autorizzazione per sottoscrivere la notifica (autorizzazione SUBSCRIBE QUERY NOTIFICATIONS per il database). SqlDependency associa la richiesta di sottoscrizione di un utente non amministratore al servizio o alla coda creata dall'amministratore.
Start(String)
Avvia il listener per ricevere notifiche di modifica delle dipendenze dall'istanza di SQL Server specificata dal stringa di connessione.
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 BooleanParametri
- connectionString
- String
Il stringa di connessione per l'istanza di SQL Server da cui ottenere le notifiche di modifica.
Valori restituiti
true se il listener è stato inizializzato correttamente; false se esiste già un listener compatibile.
Eccezioni
Il connectionString parametro è NULL.
Il connectionString parametro è uguale a una chiamata precedente a questo metodo, ma i parametri sono diversi.
Il metodo è stato chiamato dall'interno di CLR.
Il chiamante non dispone dell'autorizzazione di sicurezza dell'accesso al codice richiesta SqlClientPermission .
È stata effettuata una chiamata successiva al metodo con un parametro equivalente connectionString con un utente diverso o un utente che non ha lo stesso schema per impostazione predefinita.
Inoltre, eventuali eccezioni SqlClient sottostanti.
Commenti
Questo metodo avvia il listener per il AppDomain per ricevere notifiche di dipendenza dall'istanza di SQL Server specificata dal parametro connectionString. Questo metodo può essere chiamato più volte con stringhe di connessione diverse per più server.
Per altre osservazioni, vedere Start.
Vedi anche
Si applica a
Start(String, String)
Avvia il listener per ricevere notifiche di modifica delle dipendenze dall'istanza di SQL Server specificata dal stringa di connessione usando la coda di Service Broker SQL Server specificata.
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 BooleanParametri
- connectionString
- String
Il stringa di connessione per l'istanza di SQL Server da cui ottenere le notifiche di modifica.
- queue
- String
Coda di Service Broker SQL Server esistente da usare. Se null, viene usata la coda predefinita.
Valori restituiti
true se il listener è stato inizializzato correttamente; false se esiste già un listener compatibile.
Eccezioni
Il connectionString parametro è NULL.
Il connectionString parametro è uguale a una chiamata precedente a questo metodo, ma i parametri sono diversi.
Il metodo è stato chiamato dall'interno di CLR.
Il chiamante non dispone dell'autorizzazione di sicurezza dell'accesso al codice richiesta SqlClientPermission .
Una chiamata successiva al metodo è stata effettuata con un parametro equivalente connectionString , ma un utente diverso o un utente che per impostazione predefinita non corrisponde allo stesso schema.
Inoltre, eventuali eccezioni SqlClient sottostanti.
Commenti
Questo metodo avvia il listener per il AppDomain per ricevere notifiche di dipendenza dall'istanza di SQL Server specificata dal parametro connectionString. Questo metodo può essere chiamato più volte con stringhe di connessione diverse per più server.
Se non viene specificato alcun nome di coda, SqlDependency crea una coda temporanea e un servizio nel server usato per l'intero processo, anche se il processo prevede più di un AppDomain. La coda e il servizio vengono rimossi automaticamente al termine dell'arresto dell'applicazione.
Per altre osservazioni, vedere Start.