QueryableExtensions.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
| 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 mehr als ein Element die Bedingung erfüllt. |
| 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 mehr als ein Element in der Sequenz vorhanden ist. |
| SingleOrDefaultAsync<TSource>(IQueryable<TSource>) |
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 mehr als ein Element in der Sequenz vorhanden ist. |
| SingleOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>) |
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 mehr als ein Element die Bedingung erfüllt. |
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 mehr als ein Element die Bedingung erfüllt.
[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>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
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.
- Attribute
Ausnahmen
source oderpredicate istnull .
source implementiert IDbAsyncQueryProvider nicht.
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.
Gilt für:
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 mehr als ein Element in der Sequenz vorhanden ist.
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>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
Eine Aufgabe, die den asynchronen Vorgang darstellt.
Das Vorgangsergebnis enthält das einzelne Element der Eingabesequenz oder default (TSource), wenn die Sequenz keine Elemente enthält.
Ausnahmen
source istnull .
source hat mehr als ein Element.
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.
Gilt für:
SingleOrDefaultAsync<TSource>(IQueryable<TSource>)
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 mehr als ein Element in der Sequenz vorhanden ist.
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)Typparameter
- TSource
Der Typ der Elemente von source.
Parameter
- source
- IQueryable<TSource>
Ein IQueryable<T>, dessen einziges Element zurückgegeben werden soll
Gibt zurück
Eine Aufgabe, die den asynchronen Vorgang darstellt.
Das Vorgangsergebnis enthält das einzelne Element der Eingabesequenz oder default (TSource), wenn die Sequenz keine Elemente enthält.
Ausnahmen
source istnull .
source hat mehr als ein Element.
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.
Gilt für:
SingleOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>)
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 mehr als ein Element die Bedingung erfüllt.
[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)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.
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.
- Attribute
Ausnahmen
source oderpredicate istnull .
source implementiert IDbAsyncQueryProvider nicht.
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.
Gilt für:
Entity Framework