Freigeben über

DbSqlQuery-Klasse

  • Artikel

[Diese Seite bezieht sich auf Entity Framework Version 6. Die neueste Version ist als 'Entity Framework' NuGet-Paket verfügbar. Weitere Informationen zu Entity Framework finden Sie unter msdn.com/data/ef.]

Stellt eine SQL-Abfrage für Entitäten dar, die aus einem DbContext erstellt und mit der Verbindung aus diesem Kontext ausgeführt wird. Instanzen dieser Klasse werden aus der DbSet-Instanz für den Entitätstyp abgerufen. Die Abfrage wird nicht ausgeführt, wenn dieses Objekt erstellt wird. Sie wird jedes Mal ausgeführt, wenn es aufgelistet wird, z. B. mit foreach. SQL-Abfragen für Nichtentitäten werden mit SqlQuery(Type, String, Object[]) erstellt. Eine generische Version dieser Klasse finden Sie unter DbSqlQuery<TEntity>.

Vererbungshierarchie

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

Namespace:  System.Data.Entity.Infrastructure
Assembly:  EntityFramework (in EntityFramework.dll)

Syntax

'Declaration
<SuppressMessageAttribute("Microsoft.Design", "CA1010:CollectionsShouldImplementGenericInterface")> _
<SuppressMessageAttribute("Microsoft.Naming", "CA1710:IdentifiersShouldHaveCorrectSuffix")> _
Public Class DbSqlQuery _
    Inherits DbRawSqlQuery
'Usage
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

Der DbSqlQuery-Typ macht die folgenden Member verfügbar.

Konstruktoren

  Name Beschreibung
Geschützte Methode DbSqlQuery Erstellt eine Instanz einer DbSqlQuery beim Aufruf durch den Konstruktor eines abgeleiteten Typs, der als Test-Double für SqlQuery(String, Object[]) verwendet wird.Methoden und Eigenschaften, die vom Test-Double verwendet werden sollen, müssen vom Test-Double implementiert werden, außer AsNoTracking und AsStreaming, wo die Standardimplementierung keine Option ist.

Oben

Methoden

  Name Beschreibung
Öffentliche Methode AsNoTracking Gibt eine neue Abfrage zurück, wobei die Ergebnisse der Abfrage nicht vom zugeordneten DbContext nachverfolgt werden.
Öffentliche Methode AsStreaming Veraltet. Gibt eine neue Abfrage zurück, die die Ergebnisse streamt, anstatt sie zu puffern.
Öffentliche Methode Equals Bestimmt, ob das angegebene Objekt gleich der aktuellen Instanz ist. (Überschreibt DbRawSqlQuery.Equals(Object).)
Geschützte Methode Finalize (Von Object geerbt.)
Öffentliche Methode ForEachAsync(Action<Object>) Zählt asynchron die Abfrageergebnisse auf und führt für jedes Element die angegebene Aktion aus. (Von DbRawSqlQuery geerbt.)
Öffentliche Methode ForEachAsync(Action<Object>, CancellationToken) Zählt asynchron die Abfrageergebnisse auf und führt für jedes Element die angegebene Aktion aus. (Von DbRawSqlQuery geerbt.)
Öffentliche Methode GetEnumerator Gibt einen IEnumerator zurück, der bei der Enumeration die SQL-Abfrage für die Datenbank ausführt. (Von DbRawSqlQuery geerbt.)
Öffentliche Methode GetHashCode Gibt den Hashcode für die aktuelle Instanz zurück. (Überschreibt DbRawSqlQuery.GetHashCode().)
Öffentliche Methode GetType Ruft den Typ ab, der der Abfrage zugeordnet ist.
Geschützte Methode MemberwiseClone (Von Object geerbt.)
Öffentliche Methode ToListAsync() Erstellt aus der Abfrage eine List<T>, indem sie asynchron aufgelistet wird. (Von DbRawSqlQuery geerbt.)
Öffentliche Methode ToListAsync(CancellationToken) Erstellt aus der Abfrage eine List<T>, indem sie asynchron aufgelistet wird. (Von DbRawSqlQuery geerbt.)
Öffentliche Methode ToString Gibt einen String zurück, der die SQL-Zeichenfolge enthält, die beim Erstellen der Abfrage festgelegt wurde.Die Parameter sind nicht enthalten. (Überschreibt DbRawSqlQuery.ToString().)

Oben

Explizite Schnittstellen implementierungen

  Name Beschreibung
Explizite SchnittstellenimplementierungPrivate Eigenschaft IListSource.ContainsListCollection Gibt false zurück. (Von DbRawSqlQuery geerbt.)
Explizite SchnittstellenimplementierungPrivate Methode IListSource.GetList Löst eine Ausnahme aus, die angibt, dass das direkte Binden an eine Speicherabfrage nicht unterstützt wird. (Von DbRawSqlQuery geerbt.)
Explizite SchnittstellenimplementierungPrivate Methode IDbAsyncEnumerable.GetAsyncEnumerator Gibt einen IDbAsyncEnumerable zurück, der bei der Enumeration die SQL-Abfrage für die Datenbank ausführt. (Von DbRawSqlQuery geerbt.)

Oben

Threadsicherheit

Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Siehe auch

Verweis

System.Data.Entity.Infrastructure-Namespace