EntityFrameworkQueryableExtensions.FirstOrDefaultAsync Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Überlädt
| 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. |
FirstOrDefaultAsync<TSource>(IQueryable<TSource>, CancellationToken)
Gibt asynchron das erste Element einer Sequenz oder einen Standardwert zurück, wenn die Sequenz keine Elemente enthält.
public static System.Threading.Tasks.Task<TSource> FirstOrDefaultAsync<TSource> (this System.Linq.IQueryable<TSource> source, System.Threading.CancellationToken cancellationToken = default);public static System.Threading.Tasks.Task<TSource?> FirstOrDefaultAsync<TSource> (this System.Linq.IQueryable<TSource> source, System.Threading.CancellationToken cancellationToken = default);static member FirstOrDefaultAsync : System.Linq.IQueryable<'Source> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Source><Extension()>
Public Function FirstOrDefaultAsync(Of TSource) (source As IQueryable(Of TSource), Optional cancellationToken As CancellationToken = Nothing) As Task(Of TSource)Typparameter
- TSource
Der Typ der Elemente von source.
Parameter
- source
- IQueryable<TSource>
Ein IQueryable<T> , um das erste Element von zurückzugeben.
- cancellationToken
- CancellationToken
Ein CancellationToken , der beobachtet werden soll, während auf den Abschluss der Aufgabe gewartet wird.
Gibt zurück
Eine Aufgabe, die den asynchronen Vorgang darstellt.
Das Vorgangsergebnis enthält default ( ), wenn source leer ist, andernfalls das erste Element in sourceTSource .
Ausnahmen
source ist null
Wenn CancellationToken abgebrochen ist.
Hinweise
Mehrere aktive Vorgänge für denselben Kontext instance werden nicht unterstützt. Verwenden Sie await , um sicherzustellen, dass alle asynchronen Vorgänge abgeschlossen wurden, bevor eine andere Methode für diesen Kontext aufgerufen wird. Weitere Informationen und Beispiele finden Sie unter Vermeiden von DbContext-Threadingproblemen .
Weitere Informationen und Beispiele finden Sie unter Abfragen von Daten mit EF Core .
Gilt für:
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.
public static System.Threading.Tasks.Task<TSource> FirstOrDefaultAsync<TSource> (this System.Linq.IQueryable<TSource> source, System.Linq.Expressions.Expression<Func<TSource,bool>> predicate, System.Threading.CancellationToken cancellationToken = default);public static System.Threading.Tasks.Task<TSource?> FirstOrDefaultAsync<TSource> (this System.Linq.IQueryable<TSource> source, System.Linq.Expressions.Expression<Func<TSource,bool>> predicate, System.Threading.CancellationToken cancellationToken = default);static member FirstOrDefaultAsync : System.Linq.IQueryable<'Source> * System.Linq.Expressions.Expression<Func<'Source, bool>> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Source><Extension()>
Public Function FirstOrDefaultAsync(Of TSource) (source As IQueryable(Of TSource), predicate As Expression(Of Func(Of TSource, Boolean)), Optional cancellationToken As CancellationToken = Nothing) As Task(Of TSource)Typparameter
- TSource
Der Typ der Elemente von source.
Parameter
- source
- IQueryable<TSource>
Ein IQueryable<T> , um das erste Element von zurückzugeben.
- predicate
- Expression<Func<TSource,Boolean>>
Eine Funktion, mit der jedes Element auf eine Bedingung überprüft wird.
- cancellationToken
- CancellationToken
Ein CancellationToken , der beobachtet werden soll, während auf den Abschluss der Aufgabe gewartet wird.
Gibt zurück
Eine Aufgabe, die den asynchronen Vorgang darstellt.
Das Taskergebnis enthält default ( TSource ), wenn source leer ist oder wenn kein Element den von predicateangegebenen Test besteht, andernfalls das erste Element in source , das den durch predicateangegebenen Test besteht.
Ausnahmen
source oder predicate ist null.
Wenn CancellationToken abgebrochen ist.
Hinweise
Mehrere aktive Vorgänge für denselben Kontext instance werden nicht unterstützt. Verwenden Sie await , um sicherzustellen, dass alle asynchronen Vorgänge abgeschlossen wurden, bevor eine andere Methode für diesen Kontext aufgerufen wird. Weitere Informationen und Beispiele finden Sie unter Vermeiden von DbContext-Threadingproblemen .
Weitere Informationen und Beispiele finden Sie unter Abfragen von Daten mit EF Core .
Gilt für:
Entity Framework