SqlDependency Classe

Definizione

Oggetto SqlDependency rappresenta una dipendenza per notifica di query fra un'applicazione e un'istanza di SQL Server. Un'applicazione può creare un oggetto SqlDependency e registrarsi per ricevere notifiche tramite il gestore eventi OnChangeEventHandler.

public ref class SqlDependency sealed
public sealed class SqlDependency
type SqlDependency = class
Public NotInheritable Class SqlDependency
Ereditarietà
SqlDependency

Commenti

SqlDependency è ideale per gli scenari di memorizzazione nella cache, in cui l'applicazione ASP.NET o il servizio di livello intermedio deve mantenere determinate informazioni memorizzate nella cache in memoria. SqlDependency consente di ricevere notifiche quando i dati originali nel database vengono modificati in modo che la cache possa essere aggiornata.

Per configurare una dipendenza, è necessario associare un SqlDependency oggetto a uno o più SqlCommand oggetti. Per ricevere notifiche, è necessario sottoscrivere l'evento OnChange . Per altre informazioni sui requisiti per la creazione di query per le notifiche, vedere Uso delle notifiche delle query.

Nota

SqlDependency è stato progettato per essere usato in ASP.NET o nei servizi di livello intermedio in cui è presente un numero relativamente ridotto di server con dipendenze attive nel database. Non è stato progettato per l'uso nelle applicazioni client, in cui centinaia o migliaia di computer client avrebbero SqlDependency oggetti configurati per un singolo server di database. Se si sviluppa un'applicazione in cui sono necessarie notifiche di secondo secondario affidabili quando i dati cambiano, esaminare le sezioni Pianificazione di una strategia efficiente di notifiche delle query e alternative alle notifiche di query nell'articolo Pianificazione delle notifiche .

Per altre informazioni, vedere Notifiche di query in SQL Server e Compilazione di soluzioni di notifica.

Nota

L'evento OnChange può essere generato in un thread diverso dal thread che ha avviato l'esecuzione del comando.

Le notifiche delle query sono supportate solo per le istruzioni SELECT che soddisfano alcuni requisiti specifici.

Costruttori

SqlDependency()

Crea una nuova istanza della classe SqlDependency con le impostazioni predefinite.

SqlDependency(SqlCommand)

Crea una nuova istanza della classe SqlDependency e la associa al parametro SqlCommand.

SqlDependency(SqlCommand, String, Int32)

Crea una nuova istanza della classe SqlDependency, la associa al parametro SqlCommand e specifica le opzioni di notifica e un valore di timeout.

Proprietà

HasChanges

Ottiene un valore che indica se uno degli insiemi di risultati associati alla dipendenza è cambiato.

Id

Ottiene un valore che identifica in modo univoco questa istanza della classe SqlDependency.

Metodi

AddCommandDependency(SqlCommand)

Associa un oggetto SqlCommand a questa istanza di SqlDependency.

Start(String)

Avvia il listener per ricevere le notifiche relative alle modifiche subite dalla dipendenza dall'istanza di SQL Server specificata dalla stringa di connessione.

Start(String, String)

Avvia il listener per ricevere le notifiche relative alle modifiche apportate alla dipendenza dall'istanza di SQL Server specificata dalla stringa di connessione utilizzando la coda del Service Broker di SQL Server specificata.

Stop(String)

Arresta un listener per una connessione specificata in una chiamata Start(String) precedente.

Stop(String, String)

Arresta un listener per una connessione specificata in una chiamata Start(String, String) precedente.

Eventi

OnChange

Si verifica quando viene ricevuta una notifica per uno qualsiasi dei comandi associati all'oggetto SqlDependency.

Si applica a