DbRawSqlQuery<TElement>.SingleOrDefaultAsync-Methode (Func<TElement, Boolean>, CancellationToken)
[Diese Seite bezieht sich auf Entity Framework Version 6. Die neueste Version ist als 'Entity Framework' NuGet-Paket verfügbar. Weitere Informationen zu Entity Framework finden Sie unter msdn.com/data/ef.]
Gibt asynchron das einzige Element der Abfrage zurück, das eine angegebene Bedingung erfüllt, oder einen Standardwert, wenn kein solches Element vorhanden ist. Diese Methode löst eine Ausnahme aus, wenn mehrere Elemente die Bedingung erfüllen.
Namespace: System.Data.Entity.Infrastructure
Assembly: EntityFramework (in EntityFramework.dll)
Syntax
'Declaration
Public Function SingleOrDefaultAsync ( _
predicate As Func(Of TElement, Boolean), _
cancellationToken As CancellationToken _
) As Task(Of TElement)
'Usage
Dim instance As DbRawSqlQuery
Dim predicate As Func(Of TElement, Boolean)
Dim cancellationToken As CancellationToken
Dim returnValue As Task(Of TElement)
returnValue = instance.SingleOrDefaultAsync(predicate, _
cancellationToken)
public Task<TElement> SingleOrDefaultAsync(
Func<TElement, bool> predicate,
CancellationToken cancellationToken
)
public:
Task<TElement>^ SingleOrDefaultAsync(
Func<TElement, bool>^ predicate,
CancellationToken cancellationToken
)
member SingleOrDefaultAsync :
predicate:Func<'TElement, bool> *
cancellationToken:CancellationToken -> Task<'TElement>
public function SingleOrDefaultAsync(
predicate : Func<TElement, boolean>,
cancellationToken : CancellationToken
) : Task<TElement>
Parameter
- predicate
Typ: System.Func<TElement, Boolean>
Eine Funktion, mit der jedes Element auf eine Bedingung überprüft wird.
- cancellationToken
Typ: System.Threading.CancellationToken
Ein CancellationToken, das beim Warten auf den Abschluss der Aufgabe überwacht werden soll.
Rückgabewert
Typ: System.Threading.Tasks.Task<TElement>
Eine Aufgabe, die den asynchronen Vorgang darstellt.Das Aufgabeergebnis enthält das einzige Element des Abfrageergebnisses, das die Bedingung in predicateerfüllt, oder default ( TElement ), wenn kein solches Element gefunden wird.
Ausnahmen
| Ausnahme | Bedingung |
|---|---|
| ArgumentNullException | predicate ist null. |
| InvalidOperationException | Die Bedingung in predicate wird von mehreren Elementen erfüllt. |
Hinweise
Mehrere aktive Vorgänge für dieselbe Kontextinstanz werden nicht unterstützt. Verwenden Sie await, um sicherzustellen, dass sämtliche asynchronen Vorgänge abgeschlossen sind, bevor eine andere Methode in diesem Kontext aufgerufen wird.
Siehe auch
Verweis
DbRawSqlQuery<TElement> Klasse