Classe DbSqlQuery<TEntity>

Articolo
12/18/2014

[Questa pagina è specifica della versione 6 di Entity Framework. La versione più recente è disponibile come pacchetto NuGet per "Entity Framework". Per ulteriori informazioni su Entity Framework, vedere la pagina msdn.com/data/ef.]

Rappresenta una query SQL per entità create da un DbContext e viene eseguita utilizzando la connessione da tale contesto. Le istanze di questa classe sono ottenute dall'istanza di DbSet<TEntity> per il tipo di entità. La query non viene eseguita quando viene creato questo oggetto; viene eseguita ogni volta che viene enumerata, ad esempio tramite foreach. Le query SQL per le non entità vengono create utilizzando SqlQuery<TElement>(String, Object[]). Per una versione non generica di questa classe, vedere DbSqlQuery.

Gerarchia di ereditarietà

System.Object
System.Data.Entity.Infrastructure.DbRawSqlQuery<TEntity>
System.Data.Entity.Infrastructure.DbSqlQuery<TEntity>

Spazio dei nomi: System.Data.Entity.Infrastructure
Assembly: EntityFramework (in EntityFramework.dll)

Sintassi

'Dichiarazione
<SuppressMessageAttribute("Microsoft.Naming", "CA1710:IdentifiersShouldHaveCorrectSuffix")> _
Public Class DbSqlQuery(Of TEntity As Class) _
    Inherits DbRawSqlQuery(Of TEntity)
'Utilizzo
Dim instance As DbSqlQuery(Of TEntity)

[SuppressMessageAttribute("Microsoft.Naming", "CA1710:IdentifiersShouldHaveCorrectSuffix")]
public class DbSqlQuery<TEntity> : DbRawSqlQuery<TEntity>
where TEntity : class

[SuppressMessageAttribute(L"Microsoft.Naming", L"CA1710:IdentifiersShouldHaveCorrectSuffix")]
generic<typename TEntity>
where TEntity : ref class 
public ref class DbSqlQuery : public DbRawSqlQuery<TEntity>

[<SuppressMessageAttribute("Microsoft.Naming", "CA1710:IdentifiersShouldHaveCorrectSuffix")>]
type DbSqlQuery<'TEntity when 'TEntity : not struct> =  
    class 
        inherit DbRawSqlQuery<'TEntity>
    end

JScript does not support generic types and methods.

Parametri di tipo

TEntity
Tipo delle entità restituite dalla query.

Il tipo DbSqlQuery<TEntity> espone i seguenti membri.

Costruttori

	rapporti	Descrizione
	DbSqlQuery<TEntity>	Crea un'istanza di un oggetto DbSqlQuery<TEntity> quando chiamato dal costruttore di un tipo derivato che verrà utilizzato come copia di test per il metodo SqlQuery(String, array<Object[]).I metodi e le proprietà che verranno utilizzati dalla copia di test devono essere implementati da quest'ultima, ad eccezione di AsNoTracking e AsStreaming in cui l'implementazione predefinita non prevede alcuna operazione.

In alto

Metodi

	rapporti	Descrizione
	AllAsync(Func<TElement, Boolean>)	Determina in modo asincrono se tutti gli elementi della query soddisfano una condizione. (Ereditato da DbRawSqlQuery<TElement>)
	AllAsync(Func<TElement, Boolean>, CancellationToken)	Determina in modo asincrono se tutti gli elementi della query soddisfano una condizione. (Ereditato da DbRawSqlQuery<TElement>)
	AnyAsync()	Determina in modo asincrono se la query contiene elementi. (Ereditato da DbRawSqlQuery<TElement>)
	AnyAsync(Func<TElement, Boolean>)	Determina in modo asincrono se uno o più elementi della query soddisfano una condizione. (Ereditato da DbRawSqlQuery<TElement>)
	AnyAsync(CancellationToken)	Determina in modo asincrono se la query contiene elementi. (Ereditato da DbRawSqlQuery<TElement>)
	AnyAsync(Func<TElement, Boolean>, CancellationToken)	Determina in modo asincrono se uno o più elementi della query soddisfano una condizione. (Ereditato da DbRawSqlQuery<TElement>)
	AsNoTracking	Restituisce una nuova query in cui le entità restituite non verranno memorizzate nella cache dell'oggetto DbContext.
	AsStreaming	Obsoleta. Restituisce una nuova query che trasmetterà come flusso e non come buffer i risultati.
	ContainsAsync(TElement)	Determina in modo asincrono se la query contiene un elemento specificato utilizzando l'operatore di uguaglianza predefinito. (Ereditato da DbRawSqlQuery<TElement>)
	ContainsAsync(TElement, CancellationToken)	Determina in modo asincrono se la query contiene un elemento specificato utilizzando l'operatore di uguaglianza predefinito. (Ereditato da DbRawSqlQuery<TElement>)
	CountAsync()	Restituisce in modo asincrono il numero di elementi nella query. (Ereditato da DbRawSqlQuery<TElement>)
	CountAsync(Func<TElement, Boolean>)	Restituisce in modo asincrono il numero di elementi nella query che soddisfano una condizione. (Ereditato da DbRawSqlQuery<TElement>)
	CountAsync(CancellationToken)	Restituisce in modo asincrono il numero di elementi nella query. (Ereditato da DbRawSqlQuery<TElement>)
	CountAsync(Func<TElement, Boolean>, CancellationToken)	Restituisce in modo asincrono il numero di elementi nella query che soddisfano una condizione. (Ereditato da DbRawSqlQuery<TElement>)
	Equals	Specifica se questa istanza è uguale a un oggetto specificato. (Esegue l'override di DbRawSqlQuery<TElement>.Equals(Object)).
	Finalize	(Ereditato da Object)
	FirstAsync()	Restituisce in modo asincrono il primo elemento della query. (Ereditato da DbRawSqlQuery<TElement>)
	FirstAsync(Func<TElement, Boolean>)	Restituisce in modo asincrono il primo elemento della query che soddisfa una condizione specificata. (Ereditato da DbRawSqlQuery<TElement>)
	FirstAsync(CancellationToken)	Restituisce in modo asincrono il primo elemento della query. (Ereditato da DbRawSqlQuery<TElement>)
	FirstAsync(Func<TElement, Boolean>, CancellationToken)	Restituisce in modo asincrono il primo elemento della query che soddisfa una condizione specificata. (Ereditato da DbRawSqlQuery<TElement>)
	FirstOrDefaultAsync()	Restituisce in modo asincrono il primo elemento della query o un valore predefinito se il risultato della query non contiene elementi. (Ereditato da DbRawSqlQuery<TElement>)
	FirstOrDefaultAsync(Func<TElement, Boolean>)	Restituisce in modo asincrono il primo elemento della query che soddisfa una condizione specificata o un valore predefinito se non viene trovato un tale elemento. (Ereditato da DbRawSqlQuery<TElement>)
	FirstOrDefaultAsync(CancellationToken)	Restituisce in modo asincrono il primo elemento della query o un valore predefinito se il risultato della query non contiene elementi. (Ereditato da DbRawSqlQuery<TElement>)
	FirstOrDefaultAsync(Func<TElement, Boolean>, CancellationToken)	Restituisce in modo asincrono il primo elemento della query che soddisfa una condizione specificata o un valore predefinito se non viene trovato un tale elemento. (Ereditato da DbRawSqlQuery<TElement>)
	ForEachAsync(Action<TElement>)	Restituisce in modo asincrono i risultati della query ed esegue l'azione specificata su ogni elemento. (Ereditato da DbRawSqlQuery<TElement>)
	ForEachAsync(Action<TElement>, CancellationToken)	Restituisce in modo asincrono i risultati della query ed esegue l'azione specificata su ogni elemento. (Ereditato da DbRawSqlQuery<TElement>)
	GetEnumerator	Restituisce un oggetto IEnumerator<T> che, se enumerato, eseguirà la query SQL nel database. (Ereditato da DbRawSqlQuery<TElement>)
	GetHashCode	Ottiene il codice hash associato a questa istanza. (Esegue l'override di DbRawSqlQuery<TElement>.GetHashCode()).
	GetType	Ottiene il tipo associato a questa istanza.
	LongCountAsync()	Restituisce in modo asincrono un oggetto Int64 che rappresenta il numero totale di elementi nella query. (Ereditato da DbRawSqlQuery<TElement>)
	LongCountAsync(Func<TElement, Boolean>)	Restituisce in modo asincrono un oggetto Int64 che rappresenta il numero di elementi nella query che soddisfano una condizione. (Ereditato da DbRawSqlQuery<TElement>)
	LongCountAsync(CancellationToken)	Restituisce in modo asincrono un oggetto Int64 che rappresenta il numero totale di elementi nella query. (Ereditato da DbRawSqlQuery<TElement>)
	LongCountAsync(Func<TElement, Boolean>, CancellationToken)	Restituisce in modo asincrono un oggetto Int64 che rappresenta il numero di elementi nella query che soddisfano una condizione. (Ereditato da DbRawSqlQuery<TElement>)
	MaxAsync()	Restituisce in modo asincrono il valore massimo della query. (Ereditato da DbRawSqlQuery<TElement>)
	MaxAsync(CancellationToken)	Restituisce in modo asincrono il valore massimo della query. (Ereditato da DbRawSqlQuery<TElement>)
	MemberwiseClone	(Ereditato da Object)
	MinAsync()	Restituisce in modo asincrono il valore minimo della query. (Ereditato da DbRawSqlQuery<TElement>)
	MinAsync(CancellationToken)	Restituisce in modo asincrono il valore minimo della query. (Ereditato da DbRawSqlQuery<TElement>)
	SingleAsync()	Restituisce in modo asincrono l'unico elemento della query e genera un'eccezione se nella sequenza non è presente esattamente un solo elemento. (Ereditato da DbRawSqlQuery<TElement>)
	SingleAsync(Func<TElement, Boolean>)	Restituisce in modo asincrono l'unico elemento della query che soddisfa una condizione specificata e genera un'eccezione se esistono più elementi di tale tipo. (Ereditato da DbRawSqlQuery<TElement>)
	SingleAsync(CancellationToken)	Restituisce in modo asincrono l'unico elemento della query e genera un'eccezione se nella sequenza non è presente esattamente un solo elemento. (Ereditato da DbRawSqlQuery<TElement>)
	SingleAsync(Func<TElement, Boolean>, CancellationToken)	Restituisce in modo asincrono l'unico elemento della query che soddisfa una condizione specificata e genera un'eccezione se esistono più elementi di tale tipo. (Ereditato da DbRawSqlQuery<TElement>)
	SingleOrDefaultAsync()	Restituisce in modo asincrono l'unico elemento di una sequenza o un valore predefinito se la sequenza è vuota. Questo metodo genera un'eccezione se esistono più elementi nella sequenza. (Ereditato da DbRawSqlQuery<TElement>)
	SingleOrDefaultAsync(Func<TElement, Boolean>)	Restituisce in modo asincrono il singolo elemento della query che soddisfa una condizione specificata o un valore predefinito se tale elemento esiste. Questo metodo genera un'eccezione se più elementi soddisfano la condizione. (Ereditato da DbRawSqlQuery<TElement>)
	SingleOrDefaultAsync(CancellationToken)	Restituisce in modo asincrono l'unico elemento di una sequenza o un valore predefinito se la sequenza è vuota. Questo metodo genera un'eccezione se esistono più elementi nella sequenza. (Ereditato da DbRawSqlQuery<TElement>)
	SingleOrDefaultAsync(Func<TElement, Boolean>, CancellationToken)	Restituisce in modo asincrono il singolo elemento della query che soddisfa una condizione specificata o un valore predefinito se tale elemento esiste. Questo metodo genera un'eccezione se più elementi soddisfano la condizione. (Ereditato da DbRawSqlQuery<TElement>)
	ToArrayAsync()	Crea una matrice dalla query enumerandola in modo asincrono. (Ereditato da DbRawSqlQuery<TElement>)
	ToArrayAsync(CancellationToken)	Crea una matrice dalla query enumerandola in modo asincrono. (Ereditato da DbRawSqlQuery<TElement>)
	ToDictionaryAsync<TKey>(Func<TElement, TKey>)	Crea un oggetto Dictionary<TKey, TValue> dalla query enumerandolo in modo asincrono in base a una funzione del selettore di chiave specificata. (Ereditato da DbRawSqlQuery<TElement>)
	ToDictionaryAsync<TKey>(Func<TElement, TKey>, IEqualityComparer<TKey>)	Crea un oggetto Dictionary<TKey, TValue> dalla query enumerandolo in modo asincrono in base a una funzione del selettore di chiave specificata e a un operatore di confronto. (Ereditato da DbRawSqlQuery<TElement>)
	ToDictionaryAsync<TKey>(Func<TElement, TKey>, CancellationToken)	Crea un oggetto Dictionary<TKey, TValue> dalla query enumerandolo in modo asincrono in base a una funzione del selettore di chiave specificata. (Ereditato da DbRawSqlQuery<TElement>)
	ToDictionaryAsync<TKey>(Func<TElement, TKey>, IEqualityComparer<TKey>, CancellationToken)	Crea un oggetto Dictionary<TKey, TValue> dalla query enumerandolo in modo asincrono in base a una funzione del selettore di chiave specificata e a un operatore di confronto. (Ereditato da DbRawSqlQuery<TElement>)
	ToDictionaryAsync<TKey, TResult>(Func<TElement, TKey>, Func<TElement, TResult>)	Crea un oggetto Dictionary<TKey, TValue> dalla query enumerandolo in modo asincrono in base a una funzione del selettore di chiave specificata e a una funzione del selettore di elemento. (Ereditato da DbRawSqlQuery<TElement>)
	ToDictionaryAsync<TKey, TResult>(Func<TElement, TKey>, Func<TElement, TResult>, IEqualityComparer<TKey>)	Crea un oggetto Dictionary<TKey, TValue> dalla query enumerandolo in modo asincrono in base a una funzione del selettore di chiave specificata, a un operatore di confronto e a una funzione del selettore di elemento. (Ereditato da DbRawSqlQuery<TElement>)
	ToDictionaryAsync<TKey, TResult>(Func<TElement, TKey>, Func<TElement, TResult>, CancellationToken)	Crea un oggetto Dictionary<TKey, TValue> dalla query enumerandolo in modo asincrono in base a una funzione del selettore di chiave specificata e a una funzione del selettore di elemento. (Ereditato da DbRawSqlQuery<TElement>)
	ToDictionaryAsync<TKey, TResult>(Func<TElement, TKey>, Func<TElement, TResult>, IEqualityComparer<TKey>, CancellationToken)	Crea un oggetto Dictionary<TKey, TValue> dalla query enumerandolo in modo asincrono in base a una funzione del selettore di chiave specificata, a un operatore di confronto e a una funzione del selettore di elemento. (Ereditato da DbRawSqlQuery<TElement>)
	ToListAsync()	Crea un oggetto List<T> dalla query enumerandolo in modo asincrono. (Ereditato da DbRawSqlQuery<TElement>)
	ToListAsync(CancellationToken)	Crea un oggetto List<T> dalla query enumerandolo in modo asincrono. (Ereditato da DbRawSqlQuery<TElement>)
	ToString	Restituisce una rappresentazione di stringa di questa istanza. (Esegue l'override di DbRawSqlQuery<TElement>.ToString()).

In alto

Implementazioni esplicite dell'interfaccia

	rapporti	Descrizione
	IListSource.ContainsListCollection	Restituisce il valore false. (Ereditato da DbRawSqlQuery<TElement>)
	IEnumerable.GetEnumerator	Restituisce un oggetto IEnumerator che, se enumerato, eseguirà la query SQL nel database. (Ereditato da DbRawSqlQuery<TElement>)
	IListSource.GetList	Genera un'eccezione che indica che l'associazione diretta a una query dell'archivio non è supportata. (Ereditato da DbRawSqlQuery<TElement>)
	IDbAsyncEnumerable.GetAsyncEnumerator	Restituisce un oggetto IDbAsyncEnumerable che, se enumerato, eseguirà la query SQL nel database. (Ereditato da DbRawSqlQuery<TElement>)
	IDbAsyncEnumerable<TElement>.GetAsyncEnumerator	Restituisce un oggetto IDbAsyncEnumerator<T> che, se enumerato, eseguirà la query SQL nel database. (Ereditato da DbRawSqlQuery<TElement>)