QueryableExtensions.FirstAsync<TSource>-Methode (IQueryable<TSource>, 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 erste Element einer Sequenz zurück.
Namespace: System.Data.Entity
Assembly: EntityFramework (in EntityFramework.dll)
Syntax
'Declaration
<ExtensionAttribute> _
Public Shared Function FirstAsync(Of TSource) ( _
source As IQueryable(Of TSource), _
cancellationToken As CancellationToken _
) As Task(Of TSource)
'Usage
Dim source As IQueryable(Of TSource)
Dim cancellationToken As CancellationToken
Dim returnValue As Task(Of TSource)
returnValue = source.FirstAsync(cancellationToken)
public static Task<TSource> FirstAsync<TSource>(
this IQueryable<TSource> source,
CancellationToken cancellationToken
)
[ExtensionAttribute]
public:
generic<typename TSource>
static Task<TSource>^ FirstAsync(
IQueryable<TSource>^ source,
CancellationToken cancellationToken
)
static member FirstAsync :
source:IQueryable<'TSource> *
cancellationToken:CancellationToken -> Task<'TSource>
JScript does not support generic types and methods.
Typparameter
- TSource
Der Typ der Elemente von source.
Parameter
- source
Typ: System.Linq.IQueryable<TSource>
Eine IQueryable<T>, deren erstes Element zurückgegeben werden soll.
- 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<TSource>
Eine Aufgabe, die den asynchronen Vorgang darstellt.Das Aufgabeergebnis enthält das erste Element aus source.
Hinweis zur Verwendung
In Visual Basic und C# können Sie diese Methode als Instanzenmethode für ein beliebiges Objekt vom Typ IQueryable<TSource> aufrufen. Bei Verwendung der Syntax für Instanzenmethoden lassen Sie den ersten Parameter aus. Weitere Informationen finden Sie unter https://msdn.microsoft.com/de-de/library/bb384936(v=vs.113) oder https://msdn.microsoft.com/de-de/library/bb383977(v=vs.113).
Ausnahmen
| Ausnahme | Bedingung |
|---|---|
| ArgumentNullException | source ist null. |
| InvalidOperationException | source implementiert IDbAsyncQueryProvider nicht. |
| InvalidOperationException | Die Quellsequenz ist leer. |
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.