EntityFrameworkQueryableExtensions.SingleAsync 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
| SingleAsync<TSource>(IQueryable<TSource>, CancellationToken) |
Asynchronicznie zwraca jedyny element sekwencji i zgłasza wyjątek, jeśli nie ma dokładnie jednego elementu w sekwencji. |
| SingleAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken) |
Asynchronicznie zwraca jedyny element sekwencji, który spełnia określony warunek, i zgłasza wyjątek, jeśli istnieje więcej niż jeden taki element. |
SingleAsync<TSource>(IQueryable<TSource>, CancellationToken)
Asynchronicznie zwraca jedyny element sekwencji i zgłasza wyjątek, jeśli nie ma dokładnie jednego elementu w sekwencji.
public static System.Threading.Tasks.Task<TSource> SingleAsync<TSource>(this System.Linq.IQueryable<TSource> source, System.Threading.CancellationToken cancellationToken = default);static member SingleAsync : System.Linq.IQueryable<'Source> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Source><Extension()>
Public Function SingleAsync(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> umożliwiający zwrócenie pojedynczego elementu elementu .
- cancellationToken
- CancellationToken
Element CancellationToken do obserwowania podczas oczekiwania na ukończenie zadania.
Zwraca
Zadanie reprezentujące operację asynchroniczną. Wynik zadania zawiera pojedynczy element sekwencji danych wejściowych.
Wyjątki
source to null.
source zawiera więcej niż jeden element.
-lub-
source nie zawiera żadnych elementów.
Jeśli element CancellationToken zostanie anulowany.
Uwagi
Wiele aktywnych operacji na 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łady, zobacz Unikanie problemów z wątkami dbContext .
Aby uzyskać więcej informacji i przykłady, zobacz Wykonywanie zapytań o dane za pomocą programu EF Core .
Dotyczy
SingleAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)
Asynchronicznie zwraca jedyny element sekwencji, który spełnia określony warunek, i zgłasza wyjątek, jeśli istnieje więcej niż jeden taki element.
public static System.Threading.Tasks.Task<TSource> SingleAsync<TSource>(this System.Linq.IQueryable<TSource> source, System.Linq.Expressions.Expression<Func<TSource,bool>> predicate, System.Threading.CancellationToken cancellationToken = default);static member SingleAsync : System.Linq.IQueryable<'Source> * System.Linq.Expressions.Expression<Func<'Source, bool>> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Source><Extension()>
Public Function SingleAsync(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> umożliwiający zwrócenie pojedynczego elementu elementu .
- predicate
- Expression<Func<TSource,Boolean>>
Funkcja do testowania elementu dla warunku.
- cancellationToken
- CancellationToken
Element CancellationToken do obserwowania podczas oczekiwania na ukończenie zadania.
Zwraca
Zadanie reprezentujące operację asynchroniczną.
Wynik zadania zawiera pojedynczy element sekwencji danych wejściowych, który spełnia warunek w elemecie predicate.
Wyjątki
source lub predicate ma wartość null.
Żaden element nie spełnia warunku w elemecie predicate.
-lub-
Więcej niż jeden element spełnia warunek w elemecie predicate.
-lub-
source nie zawiera żadnych elementów.
Jeśli element CancellationToken zostanie anulowany.
Uwagi
Wiele aktywnych operacji na 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łady, zobacz Unikanie problemów z wątkami dbContext .
Aby uzyskać więcej informacji i przykłady, zobacz Wykonywanie zapytań o dane za pomocą programu EF Core .
