EntityFrameworkQueryableExtensions.SingleOrDefaultAsync Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Přetížení
| Název | Description |
|---|---|
| SingleOrDefaultAsync<TSource>(IQueryable<TSource>, CancellationToken) |
Asynchronně vrátí jediný prvek sekvence nebo výchozí hodnotu, pokud je sekvence prázdná; tato metoda vyvolá výjimku, pokud je v sekvenci více než jeden prvek. |
| SingleOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken) |
Asynchronně vrátí jediný prvek sekvence, která splňuje zadanou podmínku nebo výchozí hodnotu, pokud žádný takový prvek neexistuje; tato metoda vyvolá výjimku, pokud podmínka splňuje více než jeden prvek. |
SingleOrDefaultAsync<TSource>(IQueryable<TSource>, CancellationToken)
Asynchronně vrátí jediný prvek sekvence nebo výchozí hodnotu, pokud je sekvence prázdná; tato metoda vyvolá výjimku, pokud je v sekvenci více než jeden prvek.
public static System.Threading.Tasks.Task<TSource> SingleOrDefaultAsync<TSource>(this System.Linq.IQueryable<TSource> source, System.Threading.CancellationToken cancellationToken = default);public static System.Threading.Tasks.Task<TSource?> SingleOrDefaultAsync<TSource>(this System.Linq.IQueryable<TSource> source, System.Threading.CancellationToken cancellationToken = default);static member SingleOrDefaultAsync : System.Linq.IQueryable<'Source> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Source><Extension()>
Public Function SingleOrDefaultAsync(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
Úloha, která představuje asynchronní operaci.
Výsledek úkolu obsahuje jeden prvek vstupní sekvence, nebo default ( TSource) pokud sekvence neobsahuje žádné prvky.
Výjimky
source je null.
source obsahuje více než jeden prvek.
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 .
Platí pro
SingleOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)
Asynchronně vrátí jediný prvek sekvence, která splňuje zadanou podmínku nebo výchozí hodnotu, pokud žádný takový prvek neexistuje; tato metoda vyvolá výjimku, pokud podmínka splňuje více než jeden prvek.
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 = default);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 = default);static member SingleOrDefaultAsync : System.Linq.IQueryable<'Source> * System.Linq.Expressions.Expression<Func<'Source, bool>> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Source><Extension()>
Public Function SingleOrDefaultAsync(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
Úloha, která představuje asynchronní operaci.
Výsledek úkolu obsahuje jeden prvek vstupní sekvence, který splňuje podmínku v predicate, nebo default ( TSource ) pokud se takový prvek nenajde.
Výjimky
source nebo predicate je null.
Podmínka v predicatesplňuje více než jeden prvek .
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 .
