EntityFrameworkQueryableExtensions.SingleAsync Methode

Definition

Namespace:

Microsoft.EntityFrameworkCore

Assembly:

Microsoft.EntityFrameworkCore.dll

Paket:

Microsoft.EntityFrameworkCore v8.0.0

Überlädt

SingleAsync<TSource>(IQueryable<TSource>, CancellationToken)	Gibt asynchron das einzige Element einer Sequenz zurück und löst eine Ausnahme aus, wenn nicht genau ein Element in der Sequenz vorhanden ist.
SingleAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)	Gibt asynchron das einzige Element einer Sequenz zurück, das eine angegebene Bedingung erfüllt, und löst eine Ausnahme aus, wenn mehr als ein solches Element vorhanden ist.

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

Gibt asynchron das einzige Element einer Sequenz zurück und löst eine Ausnahme aus, wenn nicht genau ein Element in der Sequenz vorhanden ist.

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)

Typparameter

TSource

Der Typ der Elemente von source.

Parameter

source

IQueryable<TSource>

Ein IQueryable<T>, dessen einziges Element zurückgegeben werden soll

cancellationToken

CancellationToken

Ein CancellationToken , der beobachtet werden soll, während auf den Abschluss der Aufgabe gewartet wird.

Gibt zurück

Task<TSource>

Eine Aufgabe, die den asynchronen Vorgang darstellt. Das Vorgangsergebnis enthält das einzelne Element der Eingabesequenz.

Ausnahmen

ArgumentNullException

source ist null

InvalidOperationException

source enthält mehr als ein Element.

- oder -

source enthält keine Elemente.

OperationCanceledException

Wenn CancellationToken abgebrochen ist.

Hinweise

Mehrere aktive Vorgänge für denselben Kontext instance werden nicht unterstützt. Verwenden Sie await , um sicherzustellen, dass alle asynchronen Vorgänge abgeschlossen wurden, bevor eine andere Methode für diesen Kontext aufgerufen wird. Weitere Informationen und Beispiele finden Sie unter Vermeiden von DbContext-Threadingproblemen .

Weitere Informationen und Beispiele finden Sie unter Abfragen von Daten mit EF Core .

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

Gibt asynchron das einzige Element einer Sequenz zurück, das eine angegebene Bedingung erfüllt, und löst eine Ausnahme aus, wenn mehr als ein solches Element vorhanden ist.

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)

Typparameter

TSource

Der Typ der Elemente von source.

Parameter

source

IQueryable<TSource>

Ein IQueryable<T>, dessen einziges Element zurückgegeben werden soll

predicate

Expression<Func<TSource,Boolean>>

Eine Funktion zum Überprüfen eines Elements auf eine Bedingung.

cancellationToken

CancellationToken

Ein CancellationToken , der beobachtet werden soll, während auf den Abschluss der Aufgabe gewartet wird.

Gibt zurück

Task<TSource>

Eine Aufgabe, die den asynchronen Vorgang darstellt. Das Taskergebnis enthält das einzelne Element der Eingabesequenz, das die Bedingung in predicateerfüllt.

Ausnahmen

ArgumentNullException

source oder predicate ist null.

InvalidOperationException

Kein Element erfüllt die Bedingung in predicate.

- oder -

Die Bedingung in predicate wird von mehreren Elementen erfüllt.

- oder -

source enthält keine Elemente.

OperationCanceledException

Wenn CancellationToken abgebrochen ist.

Hinweise

Mehrere aktive Vorgänge für denselben Kontext instance werden nicht unterstützt. Verwenden Sie await , um sicherzustellen, dass alle asynchronen Vorgänge abgeschlossen wurden, bevor eine andere Methode für diesen Kontext aufgerufen wird. Weitere Informationen und Beispiele finden Sie unter Vermeiden von DbContext-Threadingproblemen .

Weitere Informationen und Beispiele finden Sie unter Abfragen von Daten mit EF Core .