Queryable.First Méthode

Définition

Espace de noms:

System.Linq

Assemblys:

netstandard.dll, System.Linq.Queryable.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>)

Source:

Queryable.cs

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 First<TSource>(IQueryable<TSource>) méthode génère un qui représente l’appel MethodCallExpressionFirst<TSource>(IQueryable<TSource>) lui-même en tant que méthode générique construite. Il passe ensuite la MethodCallExpressionExecute<TResult>(Expression) méthode de l’objet IQueryProvider représenté par la Provider propriété du source paramètre.

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

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

Source:

Queryable.cs

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 First<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>) méthode génère un qui représente l’appel MethodCallExpressionFirst<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>) lui-même en tant que méthode générique construite. Il passe ensuite la MethodCallExpressionExecute<TResult>(Expression) méthode de l’objet IQueryProvider représenté par la Provider propriété du source paramètre.

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