EntityFrameworkQueryableExtensions.SingleAsync Metoda

Definicja

Przestrzeń nazw:

Microsoft.EntityFrameworkCore

Zestaw:

Microsoft.EntityFrameworkCore.dll

Pakiet:

Microsoft.EntityFrameworkCore v8.0.0

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

Task<TSource>

Zadanie reprezentujące operację asynchroniczną. Wynik zadania zawiera pojedynczy element sekwencji danych wejściowych.

Wyjątki

ArgumentNullException

source to null.

InvalidOperationException

source zawiera więcej niż jeden element.

-lub-

source nie zawiera żadnych elementów.

OperationCanceledException

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 .

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

Task<TSource>

Zadanie reprezentujące operację asynchroniczną. Wynik zadania zawiera pojedynczy element sekwencji danych wejściowych, który spełnia warunek w elemecie predicate.

Wyjątki

ArgumentNullException

source lub predicate ma wartość null.

InvalidOperationException

Ż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.

OperationCanceledException

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 .