Sprache

DbSet<TEntity> Klasse

Definition

Eine DbSet<TEntity> kann zum Abfragen und Speichern von Instanzen von TEntity. LINQ-Abfragen für a DbSet<TEntity> werden in Abfragen für die Datenbank übersetzt.

public abstract class DbSet<TEntity> : Microsoft.EntityFrameworkCore.Infrastructure.IInfrastructure<IServiceProvider>, Microsoft.EntityFrameworkCore.Query.Internal.IAsyncEnumerableAccessor<TEntity>, System.Collections.Generic.IEnumerable<TEntity>, System.Linq.IQueryable<TEntity> where TEntity : class
[System.Runtime.CompilerServices.Nullable(0)]
public abstract class DbSet<TEntity> : Microsoft.EntityFrameworkCore.Infrastructure.IInfrastructure<IServiceProvider>, System.Collections.Generic.IEnumerable<TEntity>, System.ComponentModel.IListSource, System.Linq.IQueryable<TEntity> where TEntity : class
public abstract class DbSet<TEntity> : Microsoft.EntityFrameworkCore.Infrastructure.IInfrastructure<IServiceProvider>, Microsoft.EntityFrameworkCore.Query.Internal.IAsyncEnumerableAccessor<TEntity>, System.Collections.Generic.IEnumerable<TEntity>, System.ComponentModel.IListSource, System.Linq.IQueryable<TEntity> where TEntity : class
public abstract class DbSet<TEntity> : Microsoft.EntityFrameworkCore.Infrastructure.IInfrastructure<IServiceProvider>, System.Collections.Generic.IAsyncEnumerable<TEntity>, System.Collections.Generic.IEnumerable<TEntity>, System.ComponentModel.IListSource, System.Linq.IQueryable<TEntity> where TEntity : class
public abstract class DbSet<TEntity> : Microsoft.EntityFrameworkCore.Infrastructure.IInfrastructure<IServiceProvider>, System.Collections.Generic.IEnumerable<TEntity>, System.ComponentModel.IListSource, System.Linq.IQueryable<TEntity> where TEntity : class
type DbSet<'Entity (requires 'Entity : null)> = class
    interface IQueryable<'Entity (requires 'Entity : null)>
    interface seq<'Entity (requires 'Entity : null)>
    interface IEnumerable
    interface IQueryable
    interface IAsyncEnumerableAccessor<'Entity (requires 'Entity : null)>
    interface IInfrastructure<IServiceProvider>
[<System.Runtime.CompilerServices.Nullable(0)>]
type DbSet<'Entity (requires 'Entity : null)> = class
    interface IQueryable<'Entity (requires 'Entity : null)>
    interface seq<'Entity (requires 'Entity : null)>
    interface IEnumerable
    interface IQueryable
    interface IInfrastructure<IServiceProvider>
    interface IListSource
type DbSet<'Entity (requires 'Entity : null)> = class
    interface IQueryable<'Entity (requires 'Entity : null)>
    interface seq<'Entity (requires 'Entity : null)>
    interface IEnumerable
    interface IQueryable
    interface IAsyncEnumerableAccessor<'Entity (requires 'Entity : null)>
    interface IInfrastructure<IServiceProvider>
    interface IListSource
type DbSet<'Entity (requires 'Entity : null)> = class
    interface IQueryable<'Entity (requires 'Entity : null)>
    interface seq<'Entity (requires 'Entity : null)>
    interface IEnumerable
    interface IQueryable
    interface IAsyncEnumerable<'Entity (requires 'Entity : null)>
    interface IInfrastructure<IServiceProvider>
    interface IListSource
type DbSet<'Entity (requires 'Entity : null)> = class
    interface IQueryable<'Entity (requires 'Entity : null)>
    interface seq<'Entity (requires 'Entity : null)>
    interface IEnumerable
    interface IQueryable
    interface IInfrastructure<IServiceProvider>
    interface IListSource
Public MustInherit Class DbSet(Of TEntity)
Implements IAsyncEnumerableAccessor(Of TEntity), IEnumerable(Of TEntity), IInfrastructure(Of IServiceProvider), IQueryable(Of TEntity)
Public MustInherit Class DbSet(Of TEntity)
Implements IEnumerable(Of TEntity), IInfrastructure(Of IServiceProvider), IListSource, IQueryable(Of TEntity)
Public MustInherit Class DbSet(Of TEntity)
Implements IAsyncEnumerableAccessor(Of TEntity), IEnumerable(Of TEntity), IInfrastructure(Of IServiceProvider), IListSource, IQueryable(Of TEntity)
Public MustInherit Class DbSet(Of TEntity)
Implements IAsyncEnumerable(Of TEntity), IEnumerable(Of TEntity), IInfrastructure(Of IServiceProvider), IListSource, IQueryable(Of TEntity)

Typparameter

TEntity

Der Typ der Entität, die von dieser Gruppe betrieben wird.

Vererbung
DbSet<TEntity>
Abgeleitet
Attribute
Implementiert
IInfrastructure<IServiceProvider> Microsoft.EntityFrameworkCore.Query.Internal.IAsyncEnumerableAccessor<TEntity> IEnumerable<T> IEnumerable<TEntity> IEnumerable IQueryable IQueryable<TEntity> IListSource IAsyncEnumerable<TEntity>

Hinweise

Die Ergebnisse einer LINQ-Abfrage für a DbSet<TEntity> enthalten die von der Datenbank zurückgegebenen Ergebnisse und spiegeln möglicherweise keine Änderungen wider, die im Kontext vorgenommen wurden, die nicht in der Datenbank beibehalten wurden. Die Ergebnisse enthalten z. B. keine neu hinzugefügten Entitäten und können weiterhin Entitäten enthalten, die zum Löschen markiert sind.

Je nachdem, welche Datenbank verwendet wird, werden einige Teile einer LINQ-Abfrage für eine DbSet<TEntity> LINQ-Abfrage möglicherweise im Arbeitsspeicher ausgewertet, anstatt in eine Datenbankabfrage übersetzt zu werden.

DbSet<TEntity> Objekte werden in der Regel von einer DbSet<TEntity> Eigenschaft für eine abgeleitete DbContext oder von der Set<TEntity>() Methode abgerufen.

Entity Framework Core unterstützt nicht die Ausführung mehrerer paralleler Vorgänge, die für dieselbe DbContext-Instanz ausgeführt werden. Dies schließt die parallele Ausführung von asynchronen Abfragen und jede explizite gleichzeitige Verwendung aus mehreren Threads ein. Warten Sie daher immer sofort auf asynchrone Aufrufe, oder verwenden Sie separate DbContext-Instanzen für Vorgänge, die parallel ausgeführt werden. Weitere Informationen und Beispiele finden Sie unter Vermeiden von DbContext-Threadingproblemen .

Weitere Informationen und Beispiele finden Sie unter DbContext-Lebensdauer, Konfiguration und Initialisierung, Abfragen von Daten mit EF Core und Ändern der Nachverfolgung .

Konstruktoren

Name Beschreibung
DbSet<TEntity>()

Eine DbSet<TEntity> kann zum Abfragen und Speichern von Instanzen von TEntity. LINQ-Abfragen für a DbSet<TEntity> werden in Abfragen für die Datenbank übersetzt.

Eigenschaften

Name Beschreibung
EntityType

Die IEntityType diesem Satz zugeordneten Metadaten.

Local

Ruft eine LocalView<TEntity> , die eine lokale Ansicht aller hinzugefügten, unveränderten und geänderten Entitäten in diesem Satz darstellt.

Methoden

Name Beschreibung
Add(TEntity)

Beginnt mit der Nachverfolgung der angegebenen Entität und allen anderen erreichbaren Entitäten, die noch nicht nachverfolgt werden, in dem Added Zustand, dass sie beim SaveChanges() Aufrufen in die Datenbank eingefügt werden.

AddAsync(TEntity, CancellationToken)

Beginnt mit der Nachverfolgung der angegebenen Entität und allen anderen erreichbaren Entitäten, die noch nicht nachverfolgt werden, in dem Added Zustand, dass sie beim SaveChanges() Aufrufen in die Datenbank eingefügt werden.

AddRange(IEnumerable<TEntity>)

Beginnt mit der Nachverfolgung der angegebenen Entitäten und allen anderen erreichbaren Entitäten, die noch nicht nachverfolgt werden, in dem Added Zustand, dass sie beim SaveChanges() Aufruf in die Datenbank eingefügt werden.

AddRange(TEntity[])

Beginnt mit der Nachverfolgung der angegebenen Entitäten und allen anderen erreichbaren Entitäten, die noch nicht nachverfolgt werden, in dem Added Zustand, dass sie beim SaveChanges() Aufruf in die Datenbank eingefügt werden.

AddRangeAsync(IEnumerable<TEntity>, CancellationToken)

Beginnt mit der Nachverfolgung der angegebenen Entitäten und allen anderen erreichbaren Entitäten, die noch nicht nachverfolgt werden, in dem Added Zustand, dass sie beim SaveChanges() Aufruf in die Datenbank eingefügt werden.

AddRangeAsync(TEntity[])

Beginnt mit der Nachverfolgung der angegebenen Entitäten und allen anderen erreichbaren Entitäten, die noch nicht nachverfolgt werden, in dem Added Zustand, dass sie beim SaveChanges() Aufruf in die Datenbank eingefügt werden.

AsAsyncEnumerable()

Gibt dieses Objekt zurück, das als IAsyncEnumerable<T>.

AsQueryable()

Gibt dieses Objekt zurück, das als IQueryable<T>.

Attach(TEntity)

Beginnt mit der Nachverfolgung der angegebenen Entität und einträge, die standardmäßig von der angegebenen Entität mithilfe des Unchanged Zustands erreicht werden können, aber siehe unten für Fälle, in dem ein anderer Zustand verwendet wird.

AttachRange(IEnumerable<TEntity>)

Beginnt mit der Nachverfolgung der angegebenen Entitäten und Einträge, die von den angegebenen Entitäten Unchanged erreicht werden können, die den Status standardmäßig verwenden, sehen Sie sich jedoch unten an, wenn ein anderer Zustand verwendet wird.

AttachRange(TEntity[])

Beginnt mit der Nachverfolgung der angegebenen Entitäten und Einträge, die von den angegebenen Entitäten Unchanged erreicht werden können, die den Status standardmäßig verwenden, sehen Sie sich jedoch unten an, wenn ein anderer Zustand verwendet wird.

Entry(TEntity)

Ruft eine EntityEntry<TEntity> für die angegebene Entität ab. Der Eintrag bietet Zugriff auf Änderungsnachverfolgungsinformationen und -vorgänge für die Entität.

Find(Object[])

Sucht eine Entität mit den angegebenen Primärschlüsselwerten. Wenn eine Entität mit den angegebenen Primärschlüsselwerten vom Kontext nachverfolgt wird, wird sie sofort zurückgegeben, ohne eine Anforderung an die Datenbank zu stellen. Andernfalls wird eine Abfrage an die Datenbank für eine Entität mit den angegebenen Primärschlüsselwerten vorgenommen, und diese Entität, falls gefunden, wird dem Kontext angefügt und zurückgegeben. Wenn keine Entität gefunden wird, wird NULL zurückgegeben.

FindAsync(Object[], CancellationToken)

Sucht eine Entität mit den angegebenen Primärschlüsselwerten. Wenn eine Entität mit den angegebenen Primärschlüsselwerten vom Kontext nachverfolgt wird, wird sie sofort zurückgegeben, ohne eine Anforderung an die Datenbank zu stellen. Andernfalls wird eine Abfrage an die Datenbank für eine Entität mit den angegebenen Primärschlüsselwerten vorgenommen, und diese Entität, falls gefunden, wird dem Kontext angefügt und zurückgegeben. Wenn keine Entität gefunden wird, wird NULL zurückgegeben.

FindAsync(Object[])

Sucht eine Entität mit den angegebenen Primärschlüsselwerten. Wenn eine Entität mit den angegebenen Primärschlüsselwerten vom Kontext nachverfolgt wird, wird sie sofort zurückgegeben, ohne eine Anforderung an die Datenbank zu stellen. Andernfalls wird eine Abfrage an die Datenbank für eine Entität mit den angegebenen Primärschlüsselwerten vorgenommen, und diese Entität, falls gefunden, wird dem Kontext angefügt und zurückgegeben. Wenn keine Entität gefunden wird, wird NULL zurückgegeben.

GetAsyncEnumerator(CancellationToken)

Gibt einen IAsyncEnumerator<T> Wert zurück, der beim Aufzählen asynchron eine Abfrage für die Datenbank ausführt.

Remove(TEntity)

Beginnt mit der Deleted Nachverfolgung der angegebenen Entität im Zustand, sodass sie beim SaveChanges() Aufrufen aus der Datenbank entfernt wird.

RemoveRange(IEnumerable<TEntity>)

Beginnt mit der Deleted Nachverfolgung der angegebenen Entitäten im Zustand, sodass sie beim SaveChanges() Aufrufen aus der Datenbank entfernt werden.

RemoveRange(TEntity[])

Beginnt mit der Deleted Nachverfolgung der angegebenen Entitäten im Zustand, sodass sie beim SaveChanges() Aufrufen aus der Datenbank entfernt werden.

Update(TEntity)

Beginnt mit der Nachverfolgung der angegebenen Entität und einträge, die standardmäßig von der angegebenen Entität mithilfe des Modified Zustands erreicht werden können, aber siehe unten für Fälle, in dem ein anderer Zustand verwendet wird.

UpdateRange(IEnumerable<TEntity>)

Beginnt mit der Nachverfolgung der angegebenen Entitäten und Einträge, die von den angegebenen Entitäten Modified erreicht werden können, die den Status standardmäßig verwenden, sehen Sie sich jedoch unten an, wenn ein anderer Zustand verwendet wird.

UpdateRange(TEntity[])

Beginnt mit der Nachverfolgung der angegebenen Entitäten und Einträge, die von den angegebenen Entitäten Modified erreicht werden können, die den Status standardmäßig verwenden, sehen Sie sich jedoch unten an, wenn ein anderer Zustand verwendet wird.

Explizite Schnittstellenimplementierungen

Name Beschreibung
IAsyncEnumerable<TEntity>.GetAsyncEnumerator(CancellationToken)

Gibt einen IAsyncEnumerator<T> Wert zurück, der beim Aufzählen asynchron eine Abfrage für die Datenbank ausführt.

IAsyncEnumerableAccessor<TEntity>.AsyncEnumerable

Gibt einen IAsyncEnumerable<T> Wert zurück, der beim Aufzählen asynchron die Abfrage für die Datenbank ausführt.

IEnumerable.GetEnumerator()

Gibt einen IEnumerator Wert zurück, der beim Aufzählen eine Abfrage für die Datenbank ausführt, um alle Entitäten aus der Datenbank zu laden.

IEnumerable<TEntity>.GetEnumerator()

Gibt einen IEnumerator<T> Wert zurück, der beim Aufzählen eine Abfrage für die Datenbank ausführt, um alle Entitäten aus der Datenbank zu laden.

IInfrastructure<IServiceProvider>.Instance

Ruft den Bereich IServiceProvider ab, der zum Auflösen von Diensten verwendet wird.

IListSource.ContainsListCollection

Ruft einen Wert ab, der angibt, ob die Auflistung eine Auflistung von System.Collections.IList -Objekten ist. Gibt immer false zurück.

IListSource.GetList()

Diese Methode wird von Datenbindungsframeworks aufgerufen, wenn versucht wird, daten direkt an eine Bindung zu binden DbSet<TEntity>.

IQueryable.ElementType

Ruft den IQueryable-Elementtyp ab.

IQueryable.Expression

Ruft den IQueryable LINQ-Ausdruck ab.

IQueryable.Provider

Ruft den IQueryable-Anbieter ab.

Erweiterungsmethoden

Name Beschreibung
AllAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)

Bestimmt asynchron, ob alle Elemente einer Sequenz eine Bedingung erfüllen.

AnyAsync<TSource>(IQueryable<TSource>, CancellationToken)

Bestimmt asynchron, ob eine Sequenz Elemente enthält.

AnyAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)

Bestimmt asynchron, ob ein Element einer Sequenz eine Bedingung erfüllt.

AsAsyncEnumerable<TSource>(IQueryable<TSource>)

Gibt einen IAsyncEnumerable<T> Wert zurück, der asynchron aufgezählt werden kann.

AsNoTracking<TEntity>(IQueryable<TEntity>)

Die Änderungsverfolgung verfolgt keine entitäten, die von einer LINQ-Abfrage zurückgegeben werden. Wenn die Entitätsinstanzen geändert werden, wird dies nicht von der Änderungsverfolgung erkannt und SaveChanges() speichert diese Änderungen nicht in der Datenbank.

AsNoTrackingWithIdentityResolution<TEntity>(IQueryable<TEntity>)

Die Änderungsverfolgung verfolgt keine entitäten, die von einer LINQ-Abfrage zurückgegeben werden. Wenn die Entitätsinstanzen geändert werden, wird dies nicht von der Änderungsverfolgung erkannt und SaveChanges() speichert diese Änderungen nicht in der Datenbank.

AsSingleQuery<TEntity>(IQueryable<TEntity>)

Gibt eine neue Abfrage zurück, die so konfiguriert ist, dass die Auflistungen in der Abfrage in einer einzelnen Datenbankabfrage geladen werden.

AsSplitQuery<TEntity>(IQueryable<TEntity>)

Gibt eine neue Abfrage zurück, die so konfiguriert ist, dass die Auflistungen in den Abfrageergebnissen über separate Datenbankabfragen geladen werden.

AsTracking<TEntity>(IQueryable<TEntity>, QueryTrackingBehavior)

Gibt eine neue Abfrage zurück, bei der die Änderungsverfolgung änderungen nachverfolgt oder nicht für alle Entitäten, die zurückgegeben werden, abhängig vom Wert des Parameters "track". Bei der Nachverfolgung werden Änderungen an den Entitätsinstanzen erkannt und in der Datenbank beibehalten SaveChanges(). Wenn die Entitätsinstanzen nicht nachverfolgt werden, wird dies nicht von der Änderungsverfolgung erkannt und SaveChanges() speichert diese Änderungen nicht in der Datenbank.

AsTracking<TEntity>(IQueryable<TEntity>)

Gibt eine neue Abfrage zurück, bei der die Änderungsverfolgung Änderungen für alle zurückgegebenen Entitäten nachverfolgt. Alle Änderungen an den Entitätsinstanzen werden erkannt und während der Zeit in SaveChanges()der Datenbank beibehalten.

AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Decimal>>, CancellationToken)

Berechnet asynchron den Mittelwert einer Abfolge von Werten, die durch Aufrufen einer Projektionsfunktion für jedes Element der Eingabesequenz abgerufen wird.

AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Double>>, CancellationToken)

Berechnet asynchron den Mittelwert einer Abfolge von Werten, die durch Aufrufen einer Projektionsfunktion für jedes Element der Eingabesequenz abgerufen wird.

AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int32>>, CancellationToken)

Berechnet asynchron den Mittelwert einer Abfolge von Werten, die durch Aufrufen einer Projektionsfunktion für jedes Element der Eingabesequenz abgerufen wird.

AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int64>>, CancellationToken)

Berechnet asynchron den Mittelwert einer Abfolge von Werten, die durch Aufrufen einer Projektionsfunktion für jedes Element der Eingabesequenz abgerufen wird.

AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Decimal>>>, CancellationToken)

Berechnet asynchron den Mittelwert einer Abfolge von Werten, die durch Aufrufen einer Projektionsfunktion für jedes Element der Eingabesequenz abgerufen wird.

AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Double>>>, CancellationToken)

Berechnet asynchron den Mittelwert einer Abfolge von Werten, die durch Aufrufen einer Projektionsfunktion für jedes Element der Eingabesequenz abgerufen wird.

AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Int32>>>, CancellationToken)

Berechnet asynchron den Mittelwert einer Abfolge von Werten, die durch Aufrufen einer Projektionsfunktion für jedes Element der Eingabesequenz abgerufen wird.

AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Int64>>>, CancellationToken)

Berechnet asynchron den Mittelwert einer Abfolge von Werten, die durch Aufrufen einer Projektionsfunktion für jedes Element der Eingabesequenz abgerufen wird.

AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Single>>>, CancellationToken)

Berechnet asynchron den Mittelwert einer Abfolge von Werten, die durch Aufrufen einer Projektionsfunktion für jedes Element der Eingabesequenz abgerufen wird.

AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Single>>, CancellationToken)

Berechnet asynchron den Mittelwert einer Abfolge von Werten, die durch Aufrufen einer Projektionsfunktion für jedes Element der Eingabesequenz abgerufen wird.

ContainsAsync<TSource>(IQueryable<TSource>, TSource, CancellationToken)

Bestimmt asynchron, ob eine Sequenz ein angegebenes Element mithilfe des Standardmäßigen Gleichheitsabgleichs enthält.

ContainsTable<T,TKey>(DbSet<T>, String, Expression<Func<T,Object>>, String, Nullable<Int32>)

Fragt einen Volltextindex mithilfe der SQL Server-Funktion CONTAINSTABLE ab.

CountAsync<TSource>(IQueryable<TSource>, CancellationToken)

Gibt asynchron die Anzahl der Elemente in einer Sequenz zurück.

CountAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)

Gibt asynchron die Anzahl der Elemente in einer Sequenz zurück, die eine Bedingung erfüllen.

CreateProxy<TEntity>(DbSet<TEntity>, Action<TEntity>, Object[])

Erstellt eine Proxyinstanz für einen Entitätstyp, wenn die Proxyerstellung aktiviert wurde.

CreateProxy<TEntity>(DbSet<TEntity>, Object[])

Erstellt eine Proxyinstanz für einen Entitätstyp, wenn die Proxyerstellung aktiviert wurde.

ElementAtAsync<TSource>(IQueryable<TSource>, Int32, CancellationToken)

Gibt asynchron das Element an einem angegebenen Index in einer Sequenz zurück.

ElementAtOrDefaultAsync<TSource>(IQueryable<TSource>, Int32, CancellationToken)

Gibt asynchron das Element an einem angegebenen Index in einer Sequenz oder einen Standardwert zurück, wenn der Index außerhalb des Bereichs liegt.

ExecuteDelete<TSource>(IQueryable<TSource>)

Löscht alle Datenbankzeilen für die Entitätsinstanzen, die der LINQ-Abfrage aus der Datenbank entsprechen.

ExecuteDelete<TSource>(IQueryable<TSource>)

Löscht alle Datenbankzeilen für die Entitätsinstanzen, die der LINQ-Abfrage aus der Datenbank entsprechen.

ExecuteDeleteAsync<TSource>(IQueryable<TSource>, CancellationToken)

Löscht asynchron Datenbankzeilen für die Entitätsinstanzen, die der LINQ-Abfrage aus der Datenbank entsprechen.

ExecuteDeleteAsync<TSource>(IQueryable<TSource>, CancellationToken)

Löscht asynchron Datenbankzeilen für die Entitätsinstanzen, die der LINQ-Abfrage aus der Datenbank entsprechen.

ExecuteUpdate<TSource>(IQueryable<TSource>, Action<UpdateSettersBuilder<TSource>>)

Aktualisiert alle Datenbankzeilen für die Entitätsinstanzen, die der LINQ-Abfrage aus der Datenbank entsprechen.

ExecuteUpdate<TSource>(IQueryable<TSource>, Expression<Func<SetPropertyCalls<TSource>,SetPropertyCalls<TSource>>>)

Aktualisiert alle Datenbankzeilen für die Entitätsinstanzen, die der LINQ-Abfrage aus der Datenbank entsprechen.

ExecuteUpdate<TSource>(IQueryable<TSource>, Expression<Func<SetPropertyCalls<TSource>,SetPropertyCalls<TSource>>>)

Aktualisiert alle Datenbankzeilen für die Entitätsinstanzen, die der LINQ-Abfrage aus der Datenbank entsprechen.

ExecuteUpdateAsync<TSource>(IQueryable<TSource>, Action<UpdateSettersBuilder<TSource>>, CancellationToken)

Aktualisiert asynchron Datenbankzeilen für die Entitätsinstanzen, die der LINQ-Abfrage aus der Datenbank entsprechen.

ExecuteUpdateAsync<TSource>(IQueryable<TSource>, Expression<Func<SetPropertyCalls<TSource>,SetPropertyCalls<TSource>>>, CancellationToken)

Aktualisiert asynchron Datenbankzeilen für die Entitätsinstanzen, die der LINQ-Abfrage aus der Datenbank entsprechen.

ExecuteUpdateAsync<TSource>(IQueryable<TSource>, Expression<Func<SetPropertyCalls<TSource>,SetPropertyCalls<TSource>>>, CancellationToken)

Aktualisiert asynchron Datenbankzeilen für die Entitätsinstanzen, die der LINQ-Abfrage aus der Datenbank entsprechen.

FirstAsync<TSource>(IQueryable<TSource>, CancellationToken)

Gibt asynchron das erste Element einer Sequenz zurück.

FirstAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)

Gibt asynchron das erste Element einer Sequenz zurück, das eine angegebene Bedingung erfüllt.

FirstOrDefaultAsync<TSource>(IQueryable<TSource>, CancellationToken)

Gibt asynchron das erste Element einer Sequenz oder einen Standardwert zurück, wenn die Sequenz keine Elemente enthält.

FirstOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)

Gibt asynchron das erste Element einer Sequenz zurück, das eine angegebene Bedingung oder einen Standardwert erfüllt, wenn kein solches Element gefunden wird.

ForEachAsync<T>(IQueryable<T>, Action<T>, CancellationToken)

Listet die Abfrageergebnisse asynchron auf und führt die angegebene Aktion für jedes Element aus.

FreeTextTable<T,TKey>(DbSet<T>, String, Expression<Func<T,Object>>, String, Nullable<Int32>)

Fragt einen Volltextindex mithilfe der SQL Server-Funktion FREETEXTTABLE ab.

FromSql<TEntity>(DbSet<TEntity>, FormattableString)

Erstellt eine LINQ-Abfrage basierend auf einer interpolierten Zeichenfolge, die eine SQL-Abfrage darstellt.

FromSql<TEntity>(DbSet<TEntity>, FormattableString)

Erstellt eine LINQ-Abfrage basierend auf einer interpolierten Zeichenfolge, die eine SQL-Abfrage darstellt.

FromSql<TEntity>(IQueryable<TEntity>, FormattableString)
Veraltet.

Erstellt eine LINQ-Abfrage basierend auf einer interpolierten Zeichenfolge, die eine SQL-Abfrage darstellt.

Wenn der Datenbankanbieter das Verfassen in der bereitgestellten SQL-Datei unterstützt, können Sie mithilfe von LINQ-Operatoren context.Blogs.FromSql("SELECT * FROM dbo.Blogs").OrderBy(b => b.Name)über die rohe SQL-Abfrage verfassen .

Wie bei jeder API, die SQL akzeptiert, ist es wichtig, jede Benutzereingabe zu parametrisieren, um vor einem SQL-Einfügungsangriff zu schützen. Sie können interpolierte Parameterplatzhalter in die SQL-Abfragezeichenfolge einschließen. Alle interpolierten Parameterwerte, die Sie bereitstellen, werden automatisch in einen DbParameter - context.Blogs.FromSql($"SELECT * FROM [dbo].[SearchBlogs]({userSuppliedSearchTerm})")konvertiert.

FromSql<TEntity>(IQueryable<TEntity>, RawSqlString, Object[])
Veraltet.

Erstellt eine LINQ-Abfrage basierend auf einer unformatierten SQL-Abfrage.

Wenn der Datenbankanbieter das Verfassen in der bereitgestellten SQL-Datei unterstützt, können Sie mithilfe von LINQ-Operatoren context.Blogs.FromSql("SELECT * FROM dbo.Blogs").OrderBy(b => b.Name)über die rohe SQL-Abfrage verfassen .

Wie bei jeder API, die SQL akzeptiert, ist es wichtig, jede Benutzereingabe zu parametrisieren, um vor einem SQL-Einfügungsangriff zu schützen. Sie können Parameterplatzhalter in die SQL-Abfragezeichenfolge einschließen und dann Parameterwerte als zusätzliche Argumente angeben. Alle parameterwerte, die Sie angeben, werden automatisch in einen DbParameter context.Blogs.FromSql("SELECT * FROM [dbo].[SearchBlogs]({0})", userSuppliedSearchTerm)- konvertiert.

Diese Überladung akzeptiert auch DbParameter-Instanzen als Parameterwerte. Auf diese Weise können Sie benannte Parameter in der SQL-Abfragezeichenfolge verwenden – context.Blogs.FromSql("SELECT * FROM [dbo].[SearchBlogs]({@searchTerm})", new SqlParameter("@searchTerm", userSuppliedSearchTerm))

FromSql<TEntity>(IQueryable<TEntity>, String, Object[])

Erstellt eine LINQ-Abfrage basierend auf einer unformatierten SQL-Abfrage.

Wenn der Datenbankanbieter das Verfassen in der bereitgestellten SQL-Datei unterstützt, können Sie mithilfe von LINQ-Operatoren context.Blogs.FromSql("SELECT * FROM dbo.Blogs").OrderBy(b => b.Name)über die rohe SQL-Abfrage verfassen .

Wie bei jeder API, die SQL akzeptiert, ist es wichtig, jede Benutzereingabe zu parametrisieren, um vor einem SQL-Einfügungsangriff zu schützen. Sie können Parameterplatzhalter in die SQL-Abfragezeichenfolge einschließen und dann Parameterwerte als zusätzliche Argumente angeben. Alle parameterwerte, die Sie angeben, werden automatisch in einen DbParameter context.Blogs.FromSql("SELECT * FROM [dbo].[SearchBlogs]({0})", userSuppliedSearchTerm)- konvertiert.

Sie können auch einen DbParameter erstellen und als Parameterwert angeben. Auf diese Weise können Sie benannte Parameter in der SQL-Abfragezeichenfolge verwenden – context.Blogs.FromSql("SELECT * FROM [dbo].[SearchBlogs]({@searchTerm})", new SqlParameter("@searchTerm", userSuppliedSearchTerm))

FromSqlInterpolated<TEntity>(DbSet<TEntity>, FormattableString)
Veraltet.

Erstellt eine LINQ-Abfrage basierend auf einer interpolierten Zeichenfolge, die eine SQL-Abfrage darstellt.

FromSqlRaw<TEntity>(DbSet<TEntity>, String, Object[])

Erstellt eine LINQ-Abfrage basierend auf einer unformatierten SQL-Abfrage.

FromSqlRaw<TEntity>(DbSet<TEntity>, String, Object[])

Erstellt eine LINQ-Abfrage basierend auf einer unformatierten SQL-Abfrage.

GetInfrastructure<T>(IInfrastructure<T>)

Ruft den Wert aus einer Eigenschaft ab, die mithilfe von IInfrastructure<T>ausgeblendet wird.

Diese Methode wird in der Regel von Datenbankanbietern (und anderen Erweiterungen) verwendet. Sie wird in der Regel nicht im Anwendungscode verwendet.

IgnoreAutoIncludes<TEntity>(IQueryable<TEntity>)

Gibt an, dass für die aktuelle LinQ-Abfrage von Entity Framework keine auf Modellebene geladenen Navigationen angewendet werden sollen.

IgnoreQueryFilters<TEntity>(IQueryable<TEntity>, IReadOnlyCollection<String>)

Gibt an, dass für die aktuelle LinQ-Abfrage des Entity Framework keine Filter auf Entitätsebene angewendet werden sollen.

IgnoreQueryFilters<TEntity>(IQueryable<TEntity>)

Gibt an, dass für die aktuelle LinQ-Abfrage des Entity Framework keine Filter auf Entitätsebene angewendet werden sollen.

Include<TEntity,TProperty>(IQueryable<TEntity>, Expression<Func<TEntity,TProperty>>)

Gibt verwandte Entitäten an, die in die Abfrageergebnisse einbezogen werden sollen. Die einzuzugebende Navigationseigenschaft wird beginnend mit dem Typ der abgefragten Entität (TEntity) angegeben. Wenn Sie zusätzliche Typen basierend auf den Navigationseigenschaften des typs einbeziehen möchten, verketten Sie einen Aufruf nach diesem Aufruf ThenInclude<TEntity,TPreviousProperty,TProperty>(IIncludableQueryable<TEntity, IEnumerable<TPreviousProperty>>, Expression<Func<TPreviousProperty, TProperty>>) .

Include<TEntity>(IQueryable<TEntity>, String)

Gibt verwandte Entitäten an, die in die Abfrageergebnisse einbezogen werden sollen. Die einzuzugebende Navigationseigenschaft wird beginnend mit dem Typ der abgefragten Entität (TEntity) angegeben. Weitere einzuzufügende Navigationseigenschaften können durch das Zeichen "." getrennt angefügt werden.

LastAsync<TSource>(IQueryable<TSource>, CancellationToken)

Gibt asynchron das letzte Element einer Sequenz zurück.

LastAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)

Gibt asynchron das letzte Element einer Sequenz zurück, das eine angegebene Bedingung erfüllt.

LastOrDefaultAsync<TSource>(IQueryable<TSource>, CancellationToken)

Gibt asynchron das letzte Element einer Sequenz oder einen Standardwert zurück, wenn die Sequenz keine Elemente enthält.

LastOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)

Gibt asynchron das letzte Element einer Sequenz zurück, das eine angegebene Bedingung oder einen Standardwert erfüllt, wenn kein solches Element gefunden wird.

Load<TSource>(IQueryable<TSource>)

Listet die Abfrage auf. Wenn Sie Entity Framework verwenden, werden die Ergebnisse der Abfrage in den zugeordneten Kontext geladen. Dies entspricht dem Aufrufen von ToList und dem Anschließenden Auslösen der Liste (ohne den Aufwand, die Liste tatsächlich zu erstellen).

LoadAsync<TSource>(IQueryable<TSource>, CancellationToken)

Listet die Abfrage asynchron auf. Wenn Sie Entity Framework verwenden, werden die Ergebnisse der Abfrage in den zugeordneten Kontext geladen. Dies entspricht dem Aufrufen von ToList und dem Anschließenden Auslösen der Liste (ohne den Aufwand, die Liste tatsächlich zu erstellen).

LongCountAsync<TSource>(IQueryable<TSource>, CancellationToken)

Gibt asynchron ein Int64 , das die Gesamtzahl der Elemente in einer Sequenz darstellt.

LongCountAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)

Gibt asynchron ein Int64 , das die Anzahl der Elemente in einer Sequenz darstellt, die eine Bedingung erfüllen.

MaxAsync<TSource,TResult>(IQueryable<TSource>, Expression<Func<TSource,TResult>>, CancellationToken)

Ruft asynchron eine Projektionsfunktion für jedes Element einer Sequenz auf und gibt den maximal resultierenden Wert zurück.

MaxAsync<TSource>(IQueryable<TSource>, CancellationToken)

Gibt asynchron den Maximalwert einer Sequenz zurück.

MaxByAsync<TSource,TKey>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, CancellationToken)

Gibt asynchron den Maximalwert in einem generischen IQueryable<T> Wert gemäß einer angegebenen Schlüsselauswahlfunktion zurück.

MinAsync<TSource,TResult>(IQueryable<TSource>, Expression<Func<TSource,TResult>>, CancellationToken)

Ruft asynchron eine Projektionsfunktion für jedes Element einer Sequenz auf und gibt den minimalen resultierenden Wert zurück.

MinAsync<TSource>(IQueryable<TSource>, CancellationToken)

Gibt asynchron den Minimalwert einer Sequenz zurück.

MinByAsync<TSource,TKey>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, CancellationToken)

Gibt asynchron den Minimalwert in einem generischen IQueryable<T> Wert gemäß einer angegebenen Schlüsselauswahlfunktion zurück.

SingleAsync<TSource>(IQueryable<TSource>, CancellationToken)

Gibt asynchron das einzige Element einer Sequenz zurück und löst eine Ausnahme aus, wenn nicht genau ein Element in der Sequenz vorhanden ist.

SingleAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)

Gibt asynchron das einzige Element einer Sequenz zurück, das eine angegebene Bedingung erfüllt, und löst eine Ausnahme aus, wenn mehr als ein solches Element vorhanden ist.

SingleOrDefaultAsync<TSource>(IQueryable<TSource>, 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.

SingleOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)

Gibt asynchron das einzige Element einer Sequenz zurück, das eine angegebene Bedingung oder einen Standardwert erfüllt, wenn kein solches Element vorhanden ist; Diese Methode löst eine Ausnahme aus, wenn mehrere Elemente die Bedingung erfüllen.

SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Decimal>>, CancellationToken)

Berechnet asynchron die Summe der Abfolge von Werten, die durch Aufrufen einer Projektionsfunktion für jedes Element der Eingabesequenz abgerufen wird.

SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Double>>, CancellationToken)

Berechnet asynchron die Summe der Abfolge von Werten, die durch Aufrufen einer Projektionsfunktion für jedes Element der Eingabesequenz abgerufen wird.

SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int32>>, CancellationToken)

Berechnet asynchron die Summe der Abfolge von Werten, die durch Aufrufen einer Projektionsfunktion für jedes Element der Eingabesequenz abgerufen wird.

SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int64>>, CancellationToken)

Berechnet asynchron die Summe der Abfolge von Werten, die durch Aufrufen einer Projektionsfunktion für jedes Element der Eingabesequenz abgerufen wird.

SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Decimal>>>, CancellationToken)

Berechnet asynchron die Summe der Abfolge von Werten, die durch Aufrufen einer Projektionsfunktion für jedes Element der Eingabesequenz abgerufen wird.

SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Double>>>, CancellationToken)

Berechnet asynchron die Summe der Abfolge von Werten, die durch Aufrufen einer Projektionsfunktion für jedes Element der Eingabesequenz abgerufen wird.

SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Int32>>>, CancellationToken)

Berechnet asynchron die Summe der Abfolge von Werten, die durch Aufrufen einer Projektionsfunktion für jedes Element der Eingabesequenz abgerufen wird.

SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Int64>>>, CancellationToken)

Berechnet asynchron die Summe der Abfolge von Werten, die durch Aufrufen einer Projektionsfunktion für jedes Element der Eingabesequenz abgerufen wird.

SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Single>>>, CancellationToken)

Berechnet asynchron die Summe der Abfolge von Werten, die durch Aufrufen einer Projektionsfunktion für jedes Element der Eingabesequenz abgerufen wird.

SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Single>>, CancellationToken)

Berechnet asynchron die Summe der Abfolge von Werten, die durch Aufrufen einer Projektionsfunktion für jedes Element der Eingabesequenz abgerufen wird.

TagWith<T>(IQueryable<T>, String)

Fügt der Auflistung von Tags, die einer EF LINQ-Abfrage zugeordnet sind, ein Tag hinzu. Tags sind Abfrageanmerkungen, die Kontextablaufverfolgungsinformationen an verschiedenen Stellen in der Abfragepipeline bereitstellen können.

TagWithCallSite<T>(IQueryable<T>, String, Int32)

Fügt der Auflistung von Tags, die einer EF LINQ-Abfrage zugeordnet sind, ein Tag mit dem Namen der Quelldatei und Zeile hinzu, in der die Methode aufgerufen wurde, die kontextbezogene Ablaufverfolgungsinformationen an verschiedenen Stellen in der Abfragepipeline bereitstellen kann.

TemporalAll<TEntity>(DbSet<TEntity>)

Wendet den zeitlichen Vorgang "All" für das angegebene DbSet an, der alle historischen Versionen der Entitäten sowie ihren aktuellen Zustand zurückgibt.

TemporalAsOf<TEntity>(DbSet<TEntity>, DateTime)

Wendet den zeitlichen Vorgang "AsOf" für das angegebene DbSet an, der nur Elemente zurückgibt, die zu einem bestimmten Zeitpunkt in der Datenbank vorhanden waren.

TemporalBetween<TEntity>(DbSet<TEntity>, DateTime, DateTime)

Wendet den zeitlichen 'Between'-Vorgang für das angegebene DbSet an, der nur Elemente zurückgibt, die in der Datenbank zwischen zwei Punkten in der Zeit vorhanden waren.

TemporalContainedIn<TEntity>(DbSet<TEntity>, DateTime, DateTime)

Wendet den zeitlichen Vorgang "ContainedIn" für das angegebene DbSet an, der nur Elemente zurückgibt, die in der Datenbank zwischen zwei Punkten vorhanden waren.

TemporalFromTo<TEntity>(DbSet<TEntity>, DateTime, DateTime)

Wendet den zeitlichen 'FromTo'-Vorgang für das angegebene DbSet an, der nur Elemente zurückgibt, die in der Datenbank zwischen zwei Punkten vorhanden waren.

ToArrayAsync<TSource>(IQueryable<TSource>, CancellationToken)

Erstellt asynchron ein Array aus einem IQueryable<T> Array, indem es asynchron aufgezählt wird.

ToDictionaryAsync<TSource,TKey,TElement>(IQueryable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>, CancellationToken)

Erstellt eine Dictionary<TKey,TValue> aus einer IQueryable<T> Durchumerierung asynchron entsprechend einer angegebenen Tastenauswahl und einer Elementauswahlfunktion.

ToDictionaryAsync<TSource,TKey,TElement>(IQueryable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>, IEqualityComparer<TKey>, CancellationToken)

Erstellt ein Element Dictionary<TKey,TValue> aus einer IQueryable<T> Durchumerierung asynchron nach einer angegebenen Schlüsselmarkierfunktion, einem Vergleichsmodul und einer Elementmarkierfunktion.

ToDictionaryAsync<TSource,TKey>(IQueryable<TSource>, Func<TSource,TKey>, CancellationToken)

Erstellt eine Dictionary<TKey,TValue> aus einer IQueryable<T> Durchumerierung asynchron entsprechend einer angegebenen Schlüsselmarkierfunktion.

ToDictionaryAsync<TSource,TKey>(IQueryable<TSource>, Func<TSource,TKey>, IEqualityComparer<TKey>, CancellationToken)

Erstellt eine Dictionary<TKey,TValue> aus einer IQueryable<T> Durchumerierung asynchron nach einer angegebenen Schlüsselmarkierfunktion und einem Vergleichsmodul.

ToHashSetAsync<TSource>(IQueryable<TSource>, CancellationToken)

Erstellt asynchron einen aus HashSet<T> einem IQueryable<T> , indem er asynchron aufgezählt wird.

ToHashSetAsync<TSource>(IQueryable<TSource>, IEqualityComparer<TSource>, CancellationToken)

Erstellt asynchron einen aus HashSet<T> einem IQueryable<T> , indem er asynchron aufgezählt wird.

ToListAsync<TSource>(IQueryable<TSource>, CancellationToken)

Erstellt asynchron einen aus List<T> einem IQueryable<T> , indem er asynchron aufgezählt wird.

ToPageAsync<TSource>(IQueryable<TSource>, Int32, String, Nullable<Int32>, CancellationToken)

Ermöglicht das Paginieren von Abfrageergebnissen durch wiederholtes Ausführen derselben Abfrage, Übergeben von Fortsetzungstoken zum Abrufen aufeinander folgender Seiten des Resultsets und Angeben der maximalen Anzahl von Ergebnissen pro Seite.

VectorSearch<T,TVector>(DbSet<T>, Expression<Func<T,TVector>>, TVector, String)

Suchen Sie mithilfe der SQL Server-Funktion VECTOR_SEARCH() nach Vektoren, die einem bestimmten Abfragevektor ähneln.

WithApproximate<T>(IQueryable<T>)

Aktiviert die ungefähre Nachbarsuche (ANN) für eine Vektorsuchabfrage. Dies führt WITH APPROXIMATE dazu, dass der SQL-Klausel TOP hinzugefügt wird und SQL Server angewiesen wird, den Vektorindex für eine bessere Leistung zu verwenden.

WithPartitionKey<TEntity>(IQueryable<TEntity>, Object, Object, Object)

Geben Sie den Partitionsschlüssel für die Partition an, die für die Abfrage verwendet wird. Erforderlich bei Verwendung eines Ressourcentokens, das berechtigungen basierend auf einem Partitionsschlüssel für die Authentifizierung bereitstellt,

WithPartitionKey<TEntity>(IQueryable<TEntity>, Object, Object)

Geben Sie den Partitionsschlüssel für die Partition an, die für die Abfrage verwendet wird. Erforderlich bei Verwendung eines Ressourcentokens, das berechtigungen basierend auf einem Partitionsschlüssel für die Authentifizierung bereitstellt,

WithPartitionKey<TEntity>(IQueryable<TEntity>, Object)

Geben Sie den Partitionsschlüssel für die Partition an, die für die Abfrage verwendet wird. Erforderlich bei Verwendung eines Ressourcentokens, das berechtigungen basierend auf einem Partitionsschlüssel für die Authentifizierung bereitstellt,

WithPartitionKey<TEntity>(IQueryable<TEntity>, String)

Geben Sie den Partitionsschlüssel für die Partition an, die für die Abfrage verwendet wird. Erforderlich bei Verwendung eines Ressourcentokens, das berechtigungen basierend auf einem Partitionsschlüssel für die Authentifizierung bereitstellt,

Gilt für: