EntityFrameworkQueryableExtensions.SingleAsync Metoda

Definice

Obor názvů:

Microsoft.EntityFrameworkCore

Sestavení:

Microsoft.EntityFrameworkCore.dll

Balíček:

Microsoft.EntityFrameworkCore v10.0.0

Přetížení

Name	Description
SingleAsync<TSource>(IQueryable<TSource>, CancellationToken)	Asynchronně vrátí jediný prvek sekvence a vyvolá výjimku, pokud v sekvenci není právě jeden prvek.
SingleAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)	Asynchronně vrátí jediný prvek sekvence, která splňuje zadanou podmínku, a vyvolá výjimku, pokud existuje více než jeden takový prvek.

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

Zdroj:

EntityFrameworkQueryableExtensions.cs

Asynchronně vrátí jediný prvek sekvence a vyvolá výjimku, pokud v sekvenci není právě jeden prvek.

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 prvků .source

Parametry

source

IQueryable<TSource>

IQueryable<T> vrátit jeden prvek.

cancellationToken

CancellationToken

A CancellationToken , která se má sledovat při čekání na dokončení úkolu.

Návraty

Task<TSource>

Úloha, která představuje asynchronní operaci. Výsledek úkolu obsahuje jeden prvek vstupní sekvence.

Výjimky

ArgumentNullException

source je null.

InvalidOperationException

source obsahuje více než jeden prvek.

-nebo-

source neobsahuje žádné prvky.

OperationCanceledException

Pokud je zrušena CancellationToken .

Poznámky

Nepodporuje se více aktivních operací ve stejné instanci kontextu. Slouží await k zajištění toho, aby se všechny asynchronní operace dokončily před voláním jiné metody v tomto kontextu. Další informace a příklady najdete v tématu Zabránění problémům s vlákny DbContext .

Další informace a příklady najdete v tématu Dotazování na data pomocí EF Core .

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

Zdroj:

EntityFrameworkQueryableExtensions.cs

Asynchronně vrátí jediný prvek sekvence, která splňuje zadanou podmínku, a vyvolá výjimku, pokud existuje více než jeden takový prvek.

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 prvků .source

Parametry

source

IQueryable<TSource>

IQueryable<T> vrátit jeden prvek.

predicate

Expression<Func<TSource,Boolean>>

Funkce k otestování prvku pro podmínku.

cancellationToken

CancellationToken

A CancellationToken , která se má sledovat při čekání na dokončení úkolu.

Návraty

Task<TSource>

Úloha, která představuje asynchronní operaci. Výsledek úkolu obsahuje jeden prvek vstupní sekvence, který splňuje podmínku v predicate.

Výjimky

ArgumentNullException

source nebo predicate je null.

InvalidOperationException

Žádný prvek nesplňuje podmínku v predicate.

-nebo-

Podmínka v predicatesplňuje více než jeden prvek .

-nebo-

source neobsahuje žádné prvky.

OperationCanceledException

Pokud je zrušena CancellationToken .

Poznámky

Nepodporuje se více aktivních operací ve stejné instanci kontextu. Slouží await k zajištění toho, aby se všechny asynchronní operace dokončily před voláním jiné metody v tomto kontextu. Další informace a příklady najdete v tématu Zabránění problémům s vlákny DbContext .

Další informace a příklady najdete v tématu Dotazování na data pomocí EF Core .