SqlDependency Classe
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.
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 il servizio ASP.NET o 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 di query.
Nota
SqlDependency è stato progettato per essere usato in ASP.NET o servizi di livello intermedio in cui è presente un numero relativamente ridotto di server con dipendenze attive sul 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 sta sviluppando un'applicazione in cui sono necessarie notifiche secondarie affidabili quando i dati cambiano, esaminare le sezioni Pianificazione di una strategia di notifiche di query efficiente e alternative alle notifiche delle query nell'articolo Pianificazione delle notifiche.
Per altre informazioni, vedere Notifiche di query in SQL Server e creazione 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. |
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 l'oggetto Type dell'istanza corrente. (Ereditato da Object) |
MemberwiseClone() |
Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object) |
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 precedente. |
Stop(String, String) |
Arresta un listener per una connessione specificata in una chiamata Start precedente. |
ToString() |
Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object) |
Eventi
OnChange |
Si verifica quando viene ricevuta una notifica per uno qualsiasi dei comandi associati all'oggetto SqlDependency. |