Share via


Classe DbSqlQuery

[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 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(Type, String, Object[]). Per una versione generica di questa classe, vedere DbSqlQuery<TEntity>.

Gerarchia di ereditarietà

System.Object
  System.Data.Entity.Infrastructure.DbRawSqlQuery
    System.Data.Entity.Infrastructure.DbSqlQuery

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

Sintassi

'Dichiarazione
<SuppressMessageAttribute("Microsoft.Design", "CA1010:CollectionsShouldImplementGenericInterface")> _
<SuppressMessageAttribute("Microsoft.Naming", "CA1710:IdentifiersShouldHaveCorrectSuffix")> _
Public Class DbSqlQuery _
    Inherits DbRawSqlQuery
'Utilizzo
Dim instance As DbSqlQuery
[SuppressMessageAttribute("Microsoft.Design", "CA1010:CollectionsShouldImplementGenericInterface")]
[SuppressMessageAttribute("Microsoft.Naming", "CA1710:IdentifiersShouldHaveCorrectSuffix")]
public class DbSqlQuery : DbRawSqlQuery
[SuppressMessageAttribute(L"Microsoft.Design", L"CA1010:CollectionsShouldImplementGenericInterface")]
[SuppressMessageAttribute(L"Microsoft.Naming", L"CA1710:IdentifiersShouldHaveCorrectSuffix")]
public ref class DbSqlQuery : public DbRawSqlQuery
[<SuppressMessageAttribute("Microsoft.Design", "CA1010:CollectionsShouldImplementGenericInterface")>]
[<SuppressMessageAttribute("Microsoft.Naming", "CA1710:IdentifiersShouldHaveCorrectSuffix")>]
type DbSqlQuery =  
    class 
        inherit DbRawSqlQuery 
    end
public class DbSqlQuery extends DbRawSqlQuery

Il tipo DbSqlQuery espone i seguenti membri.

Costruttori

  rapporti Descrizione
Metodo protetto DbSqlQuery Crea un'istanza di un oggetto DbSqlQuery quando chiamato dal costruttore di un tipo derivato che verrà utilizzato come copia di test per il metodo SqlQuery(String, 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
Metodo pubblico AsNoTracking Restituisce una nuova query i cui risultati non verranno rilevati dall'oggetto DbContext associato.
Metodo pubblico AsStreaming Obsoleta. Restituisce una nuova query che trasmetterà come flusso e non come buffer i risultati.
Metodo pubblico Equals Determina se l'oggetto specificato è uguale all'istanza corrente. (Esegue l'override di DbRawSqlQuery.Equals(Object)).
Metodo protetto Finalize (Ereditato da Object)
Metodo pubblico ForEachAsync(Action<Object>) Restituisce in modo asincrono i risultati della query ed esegue l'azione specificata su ogni elemento. (Ereditato da DbRawSqlQuery)
Metodo pubblico ForEachAsync(Action<Object>, CancellationToken) Restituisce in modo asincrono i risultati della query ed esegue l'azione specificata su ogni elemento. (Ereditato da DbRawSqlQuery)
Metodo pubblico GetEnumerator Restituisce un oggetto IEnumerator che, se enumerato, eseguirà la query SQL nel database. (Ereditato da DbRawSqlQuery)
Metodo pubblico GetHashCode Restituisce il codice hash per l'istanza corrente. (Esegue l'override di DbRawSqlQuery.GetHashCode()).
Metodo pubblico GetType Ottiene il tipo associato alla query.
Metodo protetto MemberwiseClone (Ereditato da Object)
Metodo pubblico ToListAsync() Crea un oggetto List<T> dalla query enumerandolo in modo asincrono. (Ereditato da DbRawSqlQuery)
Metodo pubblico ToListAsync(CancellationToken) Crea un oggetto List<T> dalla query enumerandolo in modo asincrono. (Ereditato da DbRawSqlQuery)
Metodo pubblico ToString Restituisce un oggetto String che contiene la stringa SQL impostata alla creazione della query.I parametri non sono inclusi. (Esegue l'override di DbRawSqlQuery.ToString()).

In alto

Implementazioni esplicite dell'interfaccia

  rapporti Descrizione
Implementazione esplicita dell'interfacciaProprietà privata IListSource.ContainsListCollection Restituisce il valore false. (Ereditato da DbRawSqlQuery)
Implementazione esplicita dell'interfacciaMetodo privato IListSource.GetList Genera un'eccezione che indica che l'associazione diretta a una query dell'archivio non è supportata. (Ereditato da DbRawSqlQuery)
Implementazione esplicita dell'interfacciaMetodo privato IDbAsyncEnumerable.GetAsyncEnumerator Restituisce un oggetto IDbAsyncEnumerable che, se enumerato, eseguirà la query SQL nel database. (Ereditato da DbRawSqlQuery)

In alto

Thread safety

Qualsiasi membro static (Shared in Visual Basic) pubblico di questo tipo è thread-safe. Non è invece garantita la sicurezza dei membri dell'istanza.

Vedere anche

Riferimento

Spazio dei nomi System.Data.Entity.Infrastructure