EntityFrameworkQueryableExtensions.FirstOrDefaultAsync Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Przeciążenia
FirstOrDefaultAsync<TSource>(IQueryable<TSource>, CancellationToken) |
Asynchronicznie zwraca pierwszy element sekwencji lub wartość domyślną, jeśli sekwencja nie zawiera żadnych elementów. |
FirstOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken) |
Asynchronicznie zwraca pierwszy element sekwencji, który spełnia określony warunek lub wartość domyślną, jeśli taki element nie zostanie znaleziony. |
FirstOrDefaultAsync<TSource>(IQueryable<TSource>, CancellationToken)
Asynchronicznie zwraca pierwszy element sekwencji lub wartość domyślną, jeśli sekwencja nie zawiera żadnych elementów.
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)
Parametry typu
- TSource
Typ elementów elementu source
.
Parametry
- source
- IQueryable<TSource>
Element , IQueryable<T> który ma zwrócić pierwszy element.
- cancellationToken
- CancellationToken
Element CancellationToken do obserwowania podczas oczekiwania na ukończenie zadania.
Zwraca
Zadanie reprezentujące operację asynchroniczną.
Wynik zadania zawiera default
( ), jeśli source
jest pusty; w przeciwnym razie pierwszy element w source
TSource
pliku .
Wyjątki
source
to null
.
Jeśli element CancellationToken zostanie anulowany.
Uwagi
Wiele aktywnych operacji w tym samym wystąpieniu kontekstu nie jest obsługiwanych. Użyj polecenia await
, aby upewnić się, że wszystkie operacje asynchroniczne zostały ukończone przed wywołaniem innej metody w tym kontekście. Aby uzyskać więcej informacji i przykładów, zobacz Unikanie problemów z wątkami dbContext .
Aby uzyskać więcej informacji i przykładów, zobacz Wykonywanie zapytań dotyczących danych za pomocą platformy EF Core .
Dotyczy
FirstOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)
Asynchronicznie zwraca pierwszy element sekwencji, który spełnia określony warunek lub wartość domyślną, jeśli taki element nie zostanie znaleziony.
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)
Parametry typu
- TSource
Typ elementów elementu source
.
Parametry
- source
- IQueryable<TSource>
Element , IQueryable<T> który ma zwrócić pierwszy element.
- predicate
- Expression<Func<TSource,Boolean>>
Funkcja testowania każdego elementu na stanie.
- cancellationToken
- CancellationToken
Element CancellationToken do obserwowania podczas oczekiwania na ukończenie zadania.
Zwraca
Zadanie reprezentujące operację asynchroniczną.
Wynik zadania zawiera ( ), jeśli source
jest pusty lub jeśli żaden element nie przejdzie testu określonego przez predicate
, w przeciwnym razie pierwszy element w source
tym przechodzi test określony przez predicate
. TSource
default
Wyjątki
source
lub predicate
to null
.
Jeśli element CancellationToken zostanie anulowany.
Uwagi
Wiele aktywnych operacji w tym samym wystąpieniu kontekstu nie jest obsługiwanych. Użyj polecenia await
, aby upewnić się, że wszystkie operacje asynchroniczne zostały ukończone przed wywołaniem innej metody w tym kontekście. Aby uzyskać więcej informacji i przykładów, zobacz Unikanie problemów z wątkami dbContext .
Aby uzyskać więcej informacji i przykładów, zobacz Wykonywanie zapytań dotyczących danych za pomocą platformy EF Core .