QueryableExtensions.SingleOrDefaultAsync Metoda

Definicja

Przestrzeń nazw:

System.Data.Entity

Zestaw:

EntityFramework.dll

Przeciążenia

SingleOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)	Asynchronicznie zwraca jedyny element sekwencji, który spełnia określony warunek lub wartość domyślną, jeśli taki element nie istnieje; Ta metoda zgłasza wyjątek, jeśli warunek spełnia więcej niż jeden element.
SingleOrDefaultAsync<TSource>(IQueryable<TSource>, CancellationToken)	Asynchronicznie zwraca jedyny element sekwencji lub wartość domyślną, jeśli sekwencja jest pusta; Ta metoda zgłasza wyjątek, jeśli w sekwencji znajduje się więcej niż jeden element.
SingleOrDefaultAsync<TSource>(IQueryable<TSource>)	Asynchronicznie zwraca jedyny element sekwencji lub wartość domyślną, jeśli sekwencja jest pusta; Ta metoda zgłasza wyjątek, jeśli w sekwencji znajduje się więcej niż jeden element.
SingleOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>)	Asynchronicznie zwraca jedyny element sekwencji, który spełnia określony warunek lub wartość domyślną, jeśli taki element nie istnieje; Ta metoda zgłasza wyjątek, jeśli warunek spełnia więcej niż jeden element.

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

Asynchronicznie zwraca jedyny element sekwencji, który spełnia określony warunek lub wartość domyślną, jeśli taki element nie istnieje; Ta metoda zgłasza wyjątek, jeśli warunek spełnia więcej niż jeden element.

[System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Design", "CA1011:ConsiderPassingBaseTypesAsParameters")]
[System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Design", "CA1006:DoNotNestGenericTypesInMemberSignatures")]
public static System.Threading.Tasks.Task<TSource> SingleOrDefaultAsync<TSource> (this System.Linq.IQueryable<TSource> source, System.Linq.Expressions.Expression<Func<TSource,bool>> predicate, System.Threading.CancellationToken cancellationToken);

static member SingleOrDefaultAsync : System.Linq.IQueryable<'Source> * System.Linq.Expressions.Expression<Func<'Source, bool>> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Source>

Parametry typu

TSource

Typ elementów elementu source.

Parametry

source

IQueryable<TSource>

Element do IQueryable<T> zwrócenia pojedynczego 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 wejściowej, który spełnia warunek w predicateobiekcie lub default ( TSource ), jeśli taki element nie zostanie znaleziony.

Atrybuty

SuppressMessageAttribute

Wyjątki

ArgumentNullException

source lubpredicate Jestnull .

InvalidOperationException

source nie implementuje IDbAsyncQueryProvider .

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.

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

Asynchronicznie zwraca jedyny element sekwencji lub wartość domyślną, jeśli sekwencja jest pusta; Ta metoda zgłasza wyjątek, jeśli w sekwencji znajduje się więcej niż jeden element.

public static System.Threading.Tasks.Task<TSource> SingleOrDefaultAsync<TSource> (this System.Linq.IQueryable<TSource> source, System.Threading.CancellationToken cancellationToken);

static member SingleOrDefaultAsync : System.Linq.IQueryable<'Source> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Source>

Parametry typu

TSource

Typ elementów elementu source.

Parametry

source

IQueryable<TSource>

Element do IQueryable<T> zwrócenia pojedynczego 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 lub default (TSource), jeśli sekwencja nie zawiera żadnych elementów.

Wyjątki

ArgumentNullException

source Jestnull .

InvalidOperationException

source ma więcej niż jeden element.

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.

SingleOrDefaultAsync<TSource>(IQueryable<TSource>)

Asynchronicznie zwraca jedyny element sekwencji lub wartość domyślną, jeśli sekwencja jest pusta; Ta metoda zgłasza wyjątek, jeśli w sekwencji znajduje się więcej niż jeden element.

public static System.Threading.Tasks.Task<TSource> SingleOrDefaultAsync<TSource> (this System.Linq.IQueryable<TSource> source);

static member SingleOrDefaultAsync : System.Linq.IQueryable<'Source> -> System.Threading.Tasks.Task<'Source>

<Extension()>
Public Function SingleOrDefaultAsync(Of TSource) (source As IQueryable(Of TSource)) As Task(Of TSource)

Parametry typu

TSource

Typ elementów elementu source.

Parametry

source

IQueryable<TSource>

Element do IQueryable<T> zwrócenia pojedynczego elementu.

Zwraca

Task<TSource>

Zadanie reprezentujące operację asynchroniczną. Wynik zadania zawiera pojedynczy element sekwencji danych wejściowych lub default (TSource), jeśli sekwencja nie zawiera żadnych elementów.

Wyjątki

ArgumentNullException

source Jestnull .

InvalidOperationException

source ma więcej niż jeden element.

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.

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

Asynchronicznie zwraca jedyny element sekwencji, który spełnia określony warunek lub wartość domyślną, jeśli taki element nie istnieje; Ta metoda zgłasza wyjątek, jeśli warunek spełnia więcej niż jeden element.

[System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Design", "CA1006:DoNotNestGenericTypesInMemberSignatures")]
public static System.Threading.Tasks.Task<TSource> SingleOrDefaultAsync<TSource> (this System.Linq.IQueryable<TSource> source, System.Linq.Expressions.Expression<Func<TSource,bool>> predicate);

static member SingleOrDefaultAsync : System.Linq.IQueryable<'Source> * System.Linq.Expressions.Expression<Func<'Source, bool>> -> System.Threading.Tasks.Task<'Source>

<Extension()>
Public Function SingleOrDefaultAsync(Of TSource) (source As IQueryable(Of TSource), predicate As Expression(Of Func(Of TSource, Boolean))) As Task(Of TSource)

Parametry typu

TSource

Typ elementów elementu source.

Parametry

source

IQueryable<TSource>

Element do IQueryable<T> zwrócenia pojedynczego elementu.

predicate

Expression<Func<TSource,Boolean>>

Funkcja do testowania elementu dla warunku.

Zwraca

Task<TSource>

Zadanie reprezentujące operację asynchroniczną. Wynik zadania zawiera pojedynczy element sekwencji wejściowej, który spełnia warunek w predicateobiekcie lub default ( TSource ), jeśli taki element nie zostanie znaleziony.

Atrybuty

SuppressMessageAttribute

Wyjątki

ArgumentNullException

source lubpredicate Jestnull .

InvalidOperationException

source nie implementuje IDbAsyncQueryProvider .

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.