QueryableExtensions.FirstOrDefaultAsync<TSource>, méthode (IQueryable<TSource>)
[Cette page concerne Entity Framework version 6. La dernière version est disponible sous le nom de package 'Entity Framework' NuGet. Pour plus d'informations sur Entity Framework, consultez msdn.com/data/ef.]
Retourne de façon asynchrone le premier élément d'une séquence, ou une valeur par défaut si la séquence ne contient aucun élément.
Espace de noms : System.Data.Entity
Assembly : EntityFramework (dans EntityFramework.dll)
Syntaxe
'Déclaration
<ExtensionAttribute> _
Public Shared Function FirstOrDefaultAsync(Of TSource) ( _
source As IQueryable(Of TSource) _
) As Task(Of TSource)
'Utilisation
Dim source As IQueryable(Of TSource)
Dim returnValue As Task(Of TSource)
returnValue = source.FirstOrDefaultAsync()
public static Task<TSource> FirstOrDefaultAsync<TSource>(
this IQueryable<TSource> source
)
[ExtensionAttribute]
public:
generic<typename TSource>
static Task<TSource>^ FirstOrDefaultAsync(
IQueryable<TSource>^ source
)
static member FirstOrDefaultAsync :
source:IQueryable<'TSource> -> Task<'TSource>
JScript does not support generic types and methods.
Paramètres de type
- TSource
Type des éléments de source.
Paramètres
- source
Type : System.Linq.IQueryable<TSource>
IQueryable<T> duquel retourner le premier élément.
Valeur de retour
Type : System.Threading.Tasks.Task<TSource>
Tâche qui représente l'opération asynchrone.Le résultat de la tâche contient default (TSource) si source est vide ; sinon, le premier élément dans source.
Remarque sur l'utilisation
En Visual Basic et C#, vous pouvez appeler cette méthode comme une méthode d'instance sur n'importe quel objet de type IQueryable<TSource>. Lorsque vous utilisez la syntaxe des méthodes d'instance pour appeler cette méthode, omettez le premier paramètre. Pour plus d'informations, consultez https://msdn.microsoft.com/fr-fr/library/bb384936(v=vs.113) ou https://msdn.microsoft.com/fr-fr/library/bb383977(v=vs.113).
Exceptions
| Exception | Condition |
|---|---|
| ArgumentNullException | source a la valeur null. |
| InvalidOperationException | source n'implémente pas IDbAsyncQueryProvider. |
Notes
Plusieurs opérations actives sur la même instance de contexte ne sont pas prises en charge. Utilisez « await » pour garantir que toutes les opérations asynchrones sont terminées avant d'appeler une autre méthode dans ce contexte.