SqlDependency Classe

Definizione

Spazio dei nomi:
System.Data.SqlClient
Assembly:
System.Data.dll

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

public ref class SqlDependency sealed
public sealed class SqlDependency
type SqlDependency = class
Public NotInheritable Class SqlDependency
Ereditarietà
Object
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 cambiano 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.

Note

SqlDependency è stato progettato per essere usato nei servizi di ASP.NET o 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 in frazioni di secondo affidabili quando i dati vengono modificati, vedere le sezioni Pianificazione di una strategia delle notifiche delle query efficiente e Alternative alle notifiche delle query nell'articolo Pianificazione delle notifiche.

Per altre informazioni, vedere notifiche Query in SQL Server e Building Notification Solutions.

Note

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 un elenco di requisiti specifici.

Costruttori

Nome Descrizione
SqlDependency()

Crea una nuova istanza della SqlDependency classe con le impostazioni predefinite.
SqlDependency(SqlCommand, String, Int32)

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

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

Proprietà

Nome Descrizione
HasChanges

Ottiene un valore che indica se uno dei set di risultati associati alla dipendenza è stato modificato.
Id

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

Metodi

Nome Descrizione
AddCommandDependency(SqlCommand)

Associa un SqlCommand oggetto a questa SqlDependency istanza.
Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetType()

Ottiene il Type dell'istanza corrente.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale del Objectcorrente.

(Ereditato da Object)
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.
Start(String)

Avvia il listener per ricevere notifiche di modifica delle dipendenze dall'istanza di SQL Server specificata dal stringa di connessione.
Stop(String, String)

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

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

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)

Eventi

Nome Descrizione
OnChange

Si verifica quando viene ricevuta una notifica per uno dei comandi associati a questo SqlDependency oggetto.

Si applica a

Vedi anche