Freigeben über


DbSqlQuery<TEntity>-Klasse

[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<TEntity>-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<TElement>(String, Object[]) erstellt. Eine nicht generische Version dieser Klasse finden Sie unter DbSqlQuery.

Vererbungshierarchie

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

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

Syntax

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

Typparameter

  • TEntity
    Der Typ der von der Abfrage zurückgegebenen Entitäten.

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

Konstruktoren

  Name Beschreibung
Geschützte Methode DbSqlQuery<TEntity> Erstellt eine Instanz einer DbSqlQuery<TEntity> beim Aufruf durch den Konstruktor eines abgeleiteten Typs, der als Test-Double für SqlQuery(String, array<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 AllAsync(Func<TElement, Boolean>) Bestimmt asynchron, ob alle Elemente der Abfrage eine Bedingung erfüllen. (Von DbRawSqlQuery<TElement> geerbt.)
Öffentliche Methode AllAsync(Func<TElement, Boolean>, CancellationToken) Bestimmt asynchron, ob alle Elemente der Abfrage eine Bedingung erfüllen. (Von DbRawSqlQuery<TElement> geerbt.)
Öffentliche Methode AnyAsync() Bestimmt asynchron, ob die Abfrage beliebige Elemente enthält. (Von DbRawSqlQuery<TElement> geerbt.)
Öffentliche Methode AnyAsync(Func<TElement, Boolean>) Bestimmt asynchron, ob ein beliebiges Elemente der Abfrage eine Bedingung erfüllt. (Von DbRawSqlQuery<TElement> geerbt.)
Öffentliche Methode AnyAsync(CancellationToken) Bestimmt asynchron, ob die Abfrage beliebige Elemente enthält. (Von DbRawSqlQuery<TElement> geerbt.)
Öffentliche Methode AnyAsync(Func<TElement, Boolean>, CancellationToken) Bestimmt asynchron, ob ein beliebiges Elemente der Abfrage eine Bedingung erfüllt. (Von DbRawSqlQuery<TElement> geerbt.)
Öffentliche Methode AsNoTracking Gibt eine neue Abfrage zurück, wobei die zurückgegebenen Entitäten nicht im DbContext zwischengespeichert werden.
Öffentliche Methode AsStreaming Veraltet. Gibt eine neue Abfrage zurück, die die Ergebnisse streamt, anstatt sie zu puffern.
Öffentliche Methode ContainsAsync(TElement) Bestimmt asynchron mit dem Standardgleichheitsvergleich, ob die Abfrage ein angegebenes Element enthält. (Von DbRawSqlQuery<TElement> geerbt.)
Öffentliche Methode ContainsAsync(TElement, CancellationToken) Bestimmt asynchron mit dem Standardgleichheitsvergleich, ob die Abfrage ein angegebenes Element enthält. (Von DbRawSqlQuery<TElement> geerbt.)
Öffentliche Methode CountAsync() Gibt asynchron die Anzahl der Elemente in der Abfrage zurück. (Von DbRawSqlQuery<TElement> geerbt.)
Öffentliche Methode CountAsync(Func<TElement, Boolean>) Gibt asynchron die Anzahl der Elemente in der Abfrage zurück, die eine Bedingung erfüllen. (Von DbRawSqlQuery<TElement> geerbt.)
Öffentliche Methode CountAsync(CancellationToken) Gibt asynchron die Anzahl der Elemente in der Abfrage zurück. (Von DbRawSqlQuery<TElement> geerbt.)
Öffentliche Methode CountAsync(Func<TElement, Boolean>, CancellationToken) Gibt asynchron die Anzahl der Elemente in der Abfrage zurück, die eine Bedingung erfüllen. (Von DbRawSqlQuery<TElement> geerbt.)
Öffentliche Methode Equals Gibt an, ob diese Instanz gleich einem angegebenen Objekt ist. (Überschreibt DbRawSqlQuery<TElement>.Equals(Object).)
Geschützte Methode Finalize (Von Object geerbt.)
Öffentliche Methode FirstAsync() Gibt asynchron das erste Element der Abfrage zurück. (Von DbRawSqlQuery<TElement> geerbt.)
Öffentliche Methode FirstAsync(Func<TElement, Boolean>) Gibt asynchron das erste Element der Abfrage zurück, das eine angegebene Bedingung erfüllt. (Von DbRawSqlQuery<TElement> geerbt.)
Öffentliche Methode FirstAsync(CancellationToken) Gibt asynchron das erste Element der Abfrage zurück. (Von DbRawSqlQuery<TElement> geerbt.)
Öffentliche Methode FirstAsync(Func<TElement, Boolean>, CancellationToken) Gibt asynchron das erste Element der Abfrage zurück, das eine angegebene Bedingung erfüllt. (Von DbRawSqlQuery<TElement> geerbt.)
Öffentliche Methode FirstOrDefaultAsync() Gibt asynchron das erste Element der Abfrage oder einen Standardwert zurück, wenn das Abfrageergebnis keine Elemente enthält. (Von DbRawSqlQuery<TElement> geerbt.)
Öffentliche Methode FirstOrDefaultAsync(Func<TElement, Boolean>) Gibt asynchron das erste Element der Abfrage zurück, das eine angegebene Bedingung erfüllt, oder einen Standardwert, wenn kein solches Element gefunden wird. (Von DbRawSqlQuery<TElement> geerbt.)
Öffentliche Methode FirstOrDefaultAsync(CancellationToken) Gibt asynchron das erste Element der Abfrage oder einen Standardwert zurück, wenn das Abfrageergebnis keine Elemente enthält. (Von DbRawSqlQuery<TElement> geerbt.)
Öffentliche Methode FirstOrDefaultAsync(Func<TElement, Boolean>, CancellationToken) Gibt asynchron das erste Element der Abfrage zurück, das eine angegebene Bedingung erfüllt, oder einen Standardwert, wenn kein solches Element gefunden wird. (Von DbRawSqlQuery<TElement> geerbt.)
Öffentliche Methode ForEachAsync(Action<TElement>) Zählt asynchron die Abfrageergebnisse auf und führt für jedes Element die angegebene Aktion aus. (Von DbRawSqlQuery<TElement> geerbt.)
Öffentliche Methode ForEachAsync(Action<TElement>, CancellationToken) Zählt asynchron die Abfrageergebnisse auf und führt für jedes Element die angegebene Aktion aus. (Von DbRawSqlQuery<TElement> geerbt.)
Öffentliche Methode GetEnumerator Gibt einen IEnumerator<T> zurück, der bei der Enumeration die SQL-Abfrage für die Datenbank ausführt. (Von DbRawSqlQuery<TElement> geerbt.)
Öffentliche Methode GetHashCode Ruft den Hashcode ab, der dieser Instanz zugeordnet ist. (Überschreibt DbRawSqlQuery<TElement>.GetHashCode().)
Öffentliche Methode GetType Ruft den Typ ab, der dieser Instanz zugeordnet ist.
Öffentliche Methode LongCountAsync() Gibt asynchron ein Int64 zurück, das die Gesamtzahl der Elemente in der Abfrage darstellt. (Von DbRawSqlQuery<TElement> geerbt.)
Öffentliche Methode LongCountAsync(Func<TElement, Boolean>) Gibt asynchron ein Int64 zurück, das die Anzahl der Elemente in der Abfrage darstellt, die eine Bedingung erfüllen. (Von DbRawSqlQuery<TElement> geerbt.)
Öffentliche Methode LongCountAsync(CancellationToken) Gibt asynchron ein Int64 zurück, das die Gesamtzahl der Elemente in der Abfrage darstellt. (Von DbRawSqlQuery<TElement> geerbt.)
Öffentliche Methode LongCountAsync(Func<TElement, Boolean>, CancellationToken) Gibt asynchron ein Int64 zurück, das die Anzahl der Elemente in der Abfrage darstellt, die eine Bedingung erfüllen. (Von DbRawSqlQuery<TElement> geerbt.)
Öffentliche Methode MaxAsync() Gibt asynchron den maximalen Wert der Abfrage zurück. (Von DbRawSqlQuery<TElement> geerbt.)
Öffentliche Methode MaxAsync(CancellationToken) Gibt asynchron den maximalen Wert der Abfrage zurück. (Von DbRawSqlQuery<TElement> geerbt.)
Geschützte Methode MemberwiseClone (Von Object geerbt.)
Öffentliche Methode MinAsync() Gibt asynchron den Minimalwert der Abfrage zurück. (Von DbRawSqlQuery<TElement> geerbt.)
Öffentliche Methode MinAsync(CancellationToken) Gibt asynchron den Minimalwert der Abfrage zurück. (Von DbRawSqlQuery<TElement> geerbt.)
Öffentliche Methode SingleAsync() Gibt asynchron das einzige Element der Abfrage zurück und löst eine Ausnahme aus, wenn die Sequenz nicht genau ein Element enthält. (Von DbRawSqlQuery<TElement> geerbt.)
Öffentliche Methode SingleAsync(Func<TElement, Boolean>) Gibt asynchron das einzige Element einer Abfrage zurück, das eine angegebene Bedingung erfüllt, und löst eine Ausnahme aus, wenn mehrere solche Elemente vorhanden sind. (Von DbRawSqlQuery<TElement> geerbt.)
Öffentliche Methode SingleAsync(CancellationToken) Gibt asynchron das einzige Element der Abfrage zurück und löst eine Ausnahme aus, wenn die Sequenz nicht genau ein Element enthält. (Von DbRawSqlQuery<TElement> geerbt.)
Öffentliche Methode SingleAsync(Func<TElement, Boolean>, CancellationToken) Gibt asynchron das einzige Element einer Abfrage zurück, das eine angegebene Bedingung erfüllt, und löst eine Ausnahme aus, wenn mehrere solche Elemente vorhanden sind. (Von DbRawSqlQuery<TElement> geerbt.)
Öffentliche Methode SingleOrDefaultAsync() Gibt asynchron das einzige Element einer Sequenz oder einen Standardwert zurück, wenn die Sequenz leer ist. Diese Methode löst eine Ausnahme aus, wenn mehrere Elemente in der Sequenz vorhanden sind. (Von DbRawSqlQuery<TElement> geerbt.)
Öffentliche Methode SingleOrDefaultAsync(Func<TElement, Boolean>) Gibt asynchron das einzige Element der Abfrage zurück, das eine angegebene Bedingung erfüllt, oder einen Standardwert, wenn kein solches Element vorhanden ist. Diese Methode löst eine Ausnahme aus, wenn mehrere Elemente die Bedingung erfüllen. (Von DbRawSqlQuery<TElement> geerbt.)
Öffentliche Methode SingleOrDefaultAsync(CancellationToken) Gibt asynchron das einzige Element einer Sequenz oder einen Standardwert zurück, wenn die Sequenz leer ist. Diese Methode löst eine Ausnahme aus, wenn mehrere Elemente in der Sequenz vorhanden sind. (Von DbRawSqlQuery<TElement> geerbt.)
Öffentliche Methode SingleOrDefaultAsync(Func<TElement, Boolean>, CancellationToken) Gibt asynchron das einzige Element der Abfrage zurück, das eine angegebene Bedingung erfüllt, oder einen Standardwert, wenn kein solches Element vorhanden ist. Diese Methode löst eine Ausnahme aus, wenn mehrere Elemente die Bedingung erfüllen. (Von DbRawSqlQuery<TElement> geerbt.)
Öffentliche Methode ToArrayAsync() Erstellt ein Array aus der Abfrage, indem sie asynchron aufgelistet wird. (Von DbRawSqlQuery<TElement> geerbt.)
Öffentliche Methode ToArrayAsync(CancellationToken) Erstellt ein Array aus der Abfrage, indem sie asynchron aufgelistet wird. (Von DbRawSqlQuery<TElement> geerbt.)
Öffentliche Methode ToDictionaryAsync<TKey>(Func<TElement, TKey>) Erstellt aus der Abfrage ein Dictionary<TKey, TValue>, indem sie gemäß einer angegebenen Schlüsselauswahlfunktion aufgelistet wird. (Von DbRawSqlQuery<TElement> geerbt.)
Öffentliche Methode ToDictionaryAsync<TKey>(Func<TElement, TKey>, IEqualityComparer<TKey>) Erstellt aus der Abfrage ein Dictionary<TKey, TValue>, indem sie gemäß einer angegebenen Schlüsselauswahlfunktion und einem Vergleich aufgelistet wird. (Von DbRawSqlQuery<TElement> geerbt.)
Öffentliche Methode ToDictionaryAsync<TKey>(Func<TElement, TKey>, CancellationToken) Erstellt aus der Abfrage ein Dictionary<TKey, TValue>, indem sie gemäß einer angegebenen Schlüsselauswahlfunktion aufgelistet wird. (Von DbRawSqlQuery<TElement> geerbt.)
Öffentliche Methode ToDictionaryAsync<TKey>(Func<TElement, TKey>, IEqualityComparer<TKey>, CancellationToken) Erstellt aus der Abfrage ein Dictionary<TKey, TValue>, indem sie gemäß einer angegebenen Schlüsselauswahlfunktion und einem Vergleich aufgelistet wird. (Von DbRawSqlQuery<TElement> geerbt.)
Öffentliche Methode ToDictionaryAsync<TKey, TResult>(Func<TElement, TKey>, Func<TElement, TResult>) Erstellt aus der Abfrage ein Dictionary<TKey, TValue>, indem sie gemäß einer angegebenen Schlüssel- und einer Elementauswahlfunktion aufgelistet wird. (Von DbRawSqlQuery<TElement> geerbt.)
Öffentliche Methode ToDictionaryAsync<TKey, TResult>(Func<TElement, TKey>, Func<TElement, TResult>, IEqualityComparer<TKey>) Erstellt aus der Abfrage ein Dictionary<TKey, TValue>, indem sie gemäß einer angegebenen Schlüsselauswahlfunktion, einem Vergleich und einer Elementauswahlfunktion aufgelistet wird. (Von DbRawSqlQuery<TElement> geerbt.)
Öffentliche Methode ToDictionaryAsync<TKey, TResult>(Func<TElement, TKey>, Func<TElement, TResult>, CancellationToken) Erstellt aus der Abfrage ein Dictionary<TKey, TValue>, indem sie gemäß einer angegebenen Schlüssel- und einer Elementauswahlfunktion aufgelistet wird. (Von DbRawSqlQuery<TElement> geerbt.)
Öffentliche Methode ToDictionaryAsync<TKey, TResult>(Func<TElement, TKey>, Func<TElement, TResult>, IEqualityComparer<TKey>, CancellationToken) Erstellt aus der Abfrage ein Dictionary<TKey, TValue>, indem sie gemäß einer angegebenen Schlüsselauswahlfunktion, einem Vergleich und einer Elementauswahlfunktion aufgelistet wird. (Von DbRawSqlQuery<TElement> geerbt.)
Öffentliche Methode ToListAsync() Erstellt aus der Abfrage eine List<T>, indem sie asynchron aufgelistet wird. (Von DbRawSqlQuery<TElement> geerbt.)
Öffentliche Methode ToListAsync(CancellationToken) Erstellt aus der Abfrage eine List<T>, indem sie asynchron aufgelistet wird. (Von DbRawSqlQuery<TElement> geerbt.)
Öffentliche Methode ToString Gibt eine Zeichenfolgendarstellung dieser Instanz zurück. (Überschreibt DbRawSqlQuery<TElement>.ToString().)

Oben

Explizite Schnittstellen implementierungen

  Name Beschreibung
Explizite SchnittstellenimplementierungPrivate Eigenschaft IListSource.ContainsListCollection Gibt false zurück. (Von DbRawSqlQuery<TElement> geerbt.)
Explizite SchnittstellenimplementierungPrivate Methode IEnumerable.GetEnumerator Gibt einen IEnumerator zurück, der bei der Enumeration die SQL-Abfrage für die Datenbank ausführt. (Von DbRawSqlQuery<TElement> 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<TElement> 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<TElement> geerbt.)
Explizite SchnittstellenimplementierungPrivate Methode IDbAsyncEnumerable<TElement>.GetAsyncEnumerator Gibt IDbAsyncEnumerator<T> zurück, der bei der Enumeration die SQL-Abfrage für die Datenbank ausführt. (Von DbRawSqlQuery<TElement> 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