Il presente articolo è stato tradotto automaticamente. Passare il puntatore sulle frasi nell'articolo per visualizzare il testo originale. Ulteriori informazioni.

Traduzione

Originale

Questo argomento non è stato ancora valutato - Valuta questo argomento

Classe SqlDependency

.NET Framework 4.5

Altre versioni

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.

Gerarchia di ereditarietà

System.Object
System.Data.SqlClient.SqlDependency

Spazio dei nomi: System.Data.SqlClient
Assembly: System.Data (in System.Data.dll)

Sintassi

C++

public sealed class SqlDependency

Il tipo SqlDependency espone i seguenti membri.

Costruttori

	Nome	Descrizione
	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.

In alto

Proprietà

	Nome	Descrizione
	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.

In alto

Metodi

	Nome	Descrizione
	AddCommandDependency	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 per un determinato tipo. (Ereditato da Object)
	GetType	Ottiene il Type dell'istanza 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)

In alto

Eventi

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

In alto

Note

SqlDependency si presta in modo ottimale alla memorizzazione di scenari nella cache, in situazioni in cui per l'applicazione ASP.NET o il servizio di livello intermedio è essenziale tenere determinate informazioni memorizzate nella cache. SqlDependency consente di ricevere una notifica quando i dati originali nel database cambiano permettendo in tal modo di aggiornare la cache.

Per impostare una dipendenza, è necessario associare un oggetto SqlDependency a uno o più oggetti SqlCommand. Per ricevere le notifiche, è necessario sottoscrivere l'evento OnChange. Per ulteriori informazioni sui requisiti per creare le query per le notifiche, vedere "Creating a Query for Notification" in SQL Server Books Online.

Nota
L'oggetto SqlDependency è stato progettato per essere utilizzato in servizi ASP.NET o in servizi di livello intermedio in presenza di un numero relativamente basso di server con dipendenze attive nei confronti del database e non per essere utilizzato in applicazioni client, dove si conterebbero centinaia o migliaia di computer client con oggetti SqlDependency impostati per un singolo server database. Se si sviluppa un'applicazione in cui sono necessarie le sottocartelle secondo notifiche affidabili quando le modifiche dei dati, esaminare le sezioni Progettazione di una strategia di notifica delle query efficiente e Alternative a notifiche di querypianificazione per le notifiche nell'argomento nella documentazione online di SQL Server.

Nota

L'oggetto SqlDependency è stato progettato per essere utilizzato in servizi ASP.NET o in servizi di livello intermedio in presenza di un numero relativamente basso di server con dipendenze attive nei confronti del database e non per essere utilizzato in applicazioni client, dove si conterebbero centinaia o migliaia di computer client con oggetti SqlDependency impostati per un singolo server database. Se si sviluppa un'applicazione in cui sono necessarie le sottocartelle secondo notifiche affidabili quando le modifiche dei dati, esaminare le sezioni Progettazione di una strategia di notifica delle query efficiente e Alternative a notifiche di querypianificazione per le notifiche nell'argomento nella documentazione online di SQL Server.

Per ulteriori informazioni, vedere Using Query Notifications e "Building Notification Solutions" nella Documentazione online di SQL Server (informazioni in lingua inglese).

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

Le notifiche di query sono supportate solo per le istruzioni SELECT che soddisfano un elenco di specifici requisiti. Nella tabella seguente sono forniti i collegamenti alla documentazione sulle notifiche di query e Service Broker disponibili nella documentazione online di SQL Server.

Documentazione online di SQL Server 2005	Documentazione online di SQL Server 2008
Creare una query per la notifica	Creare una query per la notifica
Considerazioni sulla sicurezza del Service Broker	sicurezza e protezione (Service Broker)
Considerazioni sulla sicurezza per i servizi di notifiche	Autorizzazioni di notifica delle query
considerazioni internazionali per il Service Broker	Considerazioni di progettazione della soluzione (Service Broker)
InfoCenter lo sviluppatore del Service Broker	La guida di sviluppo (Service Broker)

Informazioni sulla versione

.NET Framework

Supportato in: 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supportato in: 4, 3.5 SP1

Piattaforme

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (ruoli di base del server non supportati), Windows Server 2008 R2 (ruoli di base del server supportati con SP1 o versione successiva, Itanium non supportato)

.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.

Codice thread safe

Qualsiasi membro static (Shared in Visual Basic) pubblico di questo tipo è thread-safe. I membri di istanza non sono garantiti come thread-safe.

Vedere anche

Riferimenti

Spazio dei nomi System.Data.SqlClient

Altre risorse

Using Query Notifications

Provider gestiti ADO.NET e Centro per sviluppatori di dataset

Il documento è risultato utile? Sì No

Non accurato

Incompleto

Ulteriori esempi di codice

La traduzione deve essere migliorata

(1500 caratteri rimanenti)

Aggiunte alla community

AGGIUNGI

Microsoft sta conducendo un sondaggio in linea per comprendere l'opinione degli utenti in merito al sito Web di MSDN. Se si sceglie di partecipare, quando si lascia il sito Web di MSDN verrà visualizzato il sondaggio in linea.

Si desidera partecipare?

Informativa sulla privacy