Queryable.First Méthode

Définition

Espace de noms:
System.Linq
Assemblys:
System.Core.dll, System.Linq.Queryable.dll
Assembly:
System.Core.dll
Assembly:
netstandard.dll

Retourne le premier élément d’une séquence.

Surcharges

Nom Description
First<TSource>(IQueryable<TSource>)

Retourne le premier élément d’une séquence.
First<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>)

Retourne le premier élément d’une séquence qui satisfait à une condition spécifiée.

First<TSource>(IQueryable<TSource>)

Retourne le premier élément d’une séquence.

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static TSource First(System::Linq::IQueryable<TSource> ^ source);
public static TSource First<TSource>(this System.Linq.IQueryable<TSource> source);
static member First : System.Linq.IQueryable<'Source> -> 'Source
<Extension()>
Public Function First(Of TSource) (source As IQueryable(Of TSource)) As TSource

Paramètres de type

TSource

Type des éléments de source.

Paramètres

source
IQueryable<TSource>

Pour IQueryable<T> renvoyer le premier élément de.

Retours

TSource

Premier élément en source.

Exceptions

ArgumentNullException

source a la valeur null.

InvalidOperationException

La séquence source est vide.

Exemples

L’exemple de code suivant montre comment retourner First<TSource>(IQueryable<TSource>) le premier élément d’une séquence.

int[] numbers = { 9, 34, 65, 92, 87, 435, 3, 54,
                    83, 23, 87, 435, 67, 12, 19 };

int first = numbers.AsQueryable().First();

Console.WriteLine(first);

/*
    This code produces the following output:

    9
*/

Dim numbers() As Integer = {9, 34, 65, 92, 87, 435, 3, 54, _
                    83, 23, 87, 435, 67, 12, 19}

Dim first As Integer = numbers.AsQueryable().First()

MsgBox(first)

' This code produces the following output:
'
' 9

Remarques

La méthode First<TSource>(IQueryable<TSource>) génère une MethodCallExpression qui représente l’appel de First<TSource>(IQueryable<TSource>) elle-même en tant que méthode générique construite. Il transmet ensuite la MethodCallExpression à la méthode Execute<TResult>(Expression) de l'IQueryProvider représentée par la propriété Provider du paramètre source.

Le comportement de requête qui se produit suite à l’exécution d’une arborescence d’expressions qui représente l’appel de First<TSource>(IQueryable<TSource>) dépend de l’implémentation du type du paramètre source. Le comportement attendu est qu’il retourne le premier élément dans source.

S’applique à

First<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>)

Retourne le premier élément d’une séquence qui satisfait à une condition spécifiée.

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static TSource First(System::Linq::IQueryable<TSource> ^ source, System::Linq::Expressions::Expression<Func<TSource, bool> ^> ^ predicate);
public static TSource First<TSource>(this System.Linq.IQueryable<TSource> source, System.Linq.Expressions.Expression<Func<TSource,bool>> predicate);
static member First : System.Linq.IQueryable<'Source> * System.Linq.Expressions.Expression<Func<'Source, bool>> -> 'Source
<Extension()>
Public Function First(Of TSource) (source As IQueryable(Of TSource), predicate As Expression(Of Func(Of TSource, Boolean))) As TSource

Paramètres de type

TSource

Type des éléments de source.

Paramètres

source
IQueryable<TSource>

À IQueryable<T> partir duquel retourner un élément.

predicate
Expression<Func<TSource,Boolean>>

Fonction permettant de tester chaque élément pour une condition.

Retours

TSource

Premier élément de ce qui source réussit le test dans predicate.

Exceptions

ArgumentNullException

source ou predicate est null.

InvalidOperationException

Aucun élément ne satisfait à la condition dans predicate.

-ou-

La séquence source est vide.

Exemples

L’exemple de code suivant montre comment retourner First<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>) le premier élément d’une séquence qui satisfait à une condition.

int[] numbers = { 9, 34, 65, 92, 87, 435, 3, 54,
                  83, 23, 87, 435, 67, 12, 19 };

// Get the first number in the array that is greater than 80.
int first = numbers.AsQueryable().First(number => number > 80);

Console.WriteLine(first);

/*
    This code produces the following output:

    92
*/

Dim numbers() As Integer = {9, 34, 65, 92, 87, 435, 3, 54, _
                  83, 23, 87, 435, 67, 12, 19}

' Get the first number in the array that is greater than 80.
Dim first As Integer = numbers.AsQueryable().First(Function(number) number > 80)

MsgBox(first)

' This code produces the following output:
'
' 92

Remarques

Cette méthode a au moins un paramètre de type Expression<TDelegate> dont l’argument de type est l’un des Func<T,TResult> types. Pour ces paramètres, vous pouvez passer une expression lambda et elle sera compilée à un Expression<TDelegate>.

La méthode First<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>) génère une MethodCallExpression qui représente l’appel de First<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>) elle-même en tant que méthode générique construite. Il transmet ensuite la MethodCallExpression à la méthode Execute<TResult>(Expression) de l'IQueryProvider représentée par la propriété Provider du paramètre source.

Le comportement de requête qui se produit suite à l’exécution d’une arborescence d’expressions qui représente l’appel de First<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>) dépend de l’implémentation du type du paramètre source. Le comportement attendu est qu’il retourne le premier élément qui source satisfait à la condition spécifiée par predicate.

S’applique à