EntityFrameworkQueryableExtensions.SingleOrDefaultAsync Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Überlädt
| Name | Beschreibung |
|---|---|
| SingleOrDefaultAsync<TSource>(IQueryable<TSource>, CancellationToken) |
Gibt asynchron das einzige Element einer Sequenz oder einen Standardwert zurück, wenn die Sequenz leer ist; Diese Methode löst eine Ausnahme aus, wenn mehrere Elemente in der Sequenz vorhanden sind. |
| SingleOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken) |
Gibt asynchron das einzige Element einer Sequenz zurück, das eine angegebene Bedingung oder einen Standardwert erfüllt, wenn kein solches Element vorhanden ist; Diese Methode löst eine Ausnahme aus, wenn mehrere Elemente die Bedingung erfüllen. |
SingleOrDefaultAsync<TSource>(IQueryable<TSource>, CancellationToken)
Gibt asynchron das einzige Element einer Sequenz oder einen Standardwert zurück, wenn die Sequenz leer ist; Diese Methode löst eine Ausnahme aus, wenn mehrere Elemente in der Sequenz vorhanden sind.
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)Typparameter
- TSource
Der Typ der Elemente von source.
Parameter
- source
- IQueryable<TSource>
Ein IQueryable<T>, um das einzelne Element zurückzugeben.
- cancellationToken
- CancellationToken
A CancellationToken , um zu beobachten, während sie auf den Abschluss der Aufgabe warten.
Gibt zurück
Eine Aufgabe, die den asynchronen Vorgang darstellt.
Das Aufgabenergebnis enthält das einzelne Element der Eingabesequenz oder default ( TSource), wenn die Sequenz keine Elemente enthält.
Ausnahmen
source ist null.
source enthält mehr als ein Element.
Wenn der CancellationToken Vorgang abgebrochen wird.
Hinweise
Mehrere aktive Vorgänge in derselben Kontextinstanz werden nicht unterstützt. Wird await verwendet, um sicherzustellen, dass alle asynchronen Vorgänge abgeschlossen wurden, bevor eine andere Methode in diesem 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 .
Gilt für:
SingleOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)
Gibt asynchron das einzige Element einer Sequenz zurück, das eine angegebene Bedingung oder einen Standardwert erfüllt, wenn kein solches Element vorhanden ist; Diese Methode löst eine Ausnahme aus, wenn mehrere Elemente die Bedingung erfüllen.
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)Typparameter
- TSource
Der Typ der Elemente von source.
Parameter
- source
- IQueryable<TSource>
Ein IQueryable<T>, um das einzelne Element zurückzugeben.
- predicate
- Expression<Func<TSource,Boolean>>
Eine Funktion zum Testen eines Elements für eine Bedingung.
- cancellationToken
- CancellationToken
A CancellationToken , um zu beobachten, während sie auf den Abschluss der Aufgabe warten.
Gibt zurück
Eine Aufgabe, die den asynchronen Vorgang darstellt.
Das Aufgabenergebnis enthält das einzelne Element der Eingabesequenz, das die Bedingung in predicateoder default ( TSource ) erfüllt, wenn kein solches Element gefunden wird.
Ausnahmen
source oder predicate ist null.
Mehr als ein Element erfüllt die Bedingung in predicate.
Wenn der CancellationToken Vorgang abgebrochen wird.
Hinweise
Mehrere aktive Vorgänge in derselben Kontextinstanz werden nicht unterstützt. Wird await verwendet, um sicherzustellen, dass alle asynchronen Vorgänge abgeschlossen wurden, bevor eine andere Methode in diesem 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 .
