QueryableExtensions.FirstOrDefaultAsync<TSource>, méthode (IQueryable<TSource>, Expression<Func<TSource, Boolean>>, CancellationToken)

Article
12/22/2014

[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 qui satisfait une condition spécifiée ou une valeur par défaut si aucun élément ne correspond.

Espace de noms : System.Data.Entity
Assembly : EntityFramework (dans EntityFramework.dll)

Syntaxe

'Déclaration
<SuppressMessageAttribute("Microsoft.Design", "CA1011:ConsiderPassingBaseTypesAsParameters")> _
<SuppressMessageAttribute("Microsoft.Design", "CA1006:DoNotNestGenericTypesInMemberSignatures")> _
<ExtensionAttribute> _
Public Shared Function FirstOrDefaultAsync(Of TSource) ( _
    source As IQueryable(Of TSource), _
    predicate As Expression(Of Func(Of TSource, Boolean)), _
    cancellationToken As CancellationToken _
) As Task(Of TSource)
'Utilisation
Dim source As IQueryable(Of TSource)
Dim predicate As Expression(Of Func(Of TSource, Boolean))
Dim cancellationToken As CancellationToken 
Dim returnValue As Task(Of TSource)

returnValue = source.FirstOrDefaultAsync(predicate, _
    cancellationToken)

[SuppressMessageAttribute("Microsoft.Design", "CA1011:ConsiderPassingBaseTypesAsParameters")]
[SuppressMessageAttribute("Microsoft.Design", "CA1006:DoNotNestGenericTypesInMemberSignatures")]
public static Task<TSource> FirstOrDefaultAsync<TSource>(
    this IQueryable<TSource> source,
    Expression<Func<TSource, bool>> predicate,
    CancellationToken cancellationToken
)

[SuppressMessageAttribute(L"Microsoft.Design", L"CA1011:ConsiderPassingBaseTypesAsParameters")]
[SuppressMessageAttribute(L"Microsoft.Design", L"CA1006:DoNotNestGenericTypesInMemberSignatures")]
[ExtensionAttribute]
public:
generic<typename TSource>
static Task<TSource>^ FirstOrDefaultAsync(
    IQueryable<TSource>^ source, 
    Expression<Func<TSource, bool>^>^ predicate, 
    CancellationToken cancellationToken
)

[<SuppressMessageAttribute("Microsoft.Design", "CA1011:ConsiderPassingBaseTypesAsParameters")>]
[<SuppressMessageAttribute("Microsoft.Design", "CA1006:DoNotNestGenericTypesInMemberSignatures")>]
static member FirstOrDefaultAsync : 
        source:IQueryable<'TSource> * 
        predicate:Expression<Func<'TSource, bool>> * 
        cancellationToken:CancellationToken -> 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.

predicate
Type : System.Linq.Expressions.Expression<Func<TSource, Boolean>>
Fonction permettant de tester chaque élément par rapport à une condition.

cancellationToken
Type : System.Threading.CancellationToken
CancellationToken à observer en attendant que la tâche se termine.

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 ou si aucun élément ne réussit le test spécifié par predicate ; sinon, le premier élément dans source qui réussit le test spécifié par predicate.

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 ou predicate a la valeur null.
InvalidOperationException	source n'implémente pas IDbAsyncQueryProvider.
InvalidOperationException	source a plusieurs éléments.

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.