Enumerable.First Méthode

Définition

Espace de noms:
System.Linq
Assembly:
System.Linq.dll
Assembly:
System.Core.dll
Assembly:
netstandard.dll

Retourne le premier élément d'une séquence.Returns the first element of a sequence.

Surcharges

First<TSource>(IEnumerable<TSource>)

Retourne le premier élément d'une séquence.Returns the first element of a sequence.
First<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>)

Retourne le premier élément d’une séquence à satisfaire à la condition spécifiée.Returns the first element in a sequence that satisfies a specified condition.

First<TSource>(IEnumerable<TSource>)

Retourne le premier élément d'une séquence.Returns the first element of a sequence.

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

Paramètres de type

TSource

Le type des éléments de source.The type of the elements of source.

Paramètres

source
IEnumerable<TSource>

IEnumerable<T> duquel retourner le premier élément.The IEnumerable<T> to return the first element of.

Retours

TSource

Premier élément de la séquence spécifiée.The first element in the specified sequence.

Exceptions

ArgumentNullException

source a la valeur null.source is null.

InvalidOperationException

La séquence source est vide.The source sequence is empty.

Exemples

L’exemple de code suivant montre comment utiliser First<TSource>(IEnumerable<TSource>) pour retourner le premier élément d’un tableau.The following code example demonstrates how to use First<TSource>(IEnumerable<TSource>) to return the first element of an array.

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

int first = numbers.First();

Console.WriteLine(first);

/*
 This code produces the following output:

 9
*/

' Create an array of integers.
Dim numbers() As Integer =
{9, 34, 65, 92, 87, 435, 3, 54, 83, 23, 87, 435, 67, 12, 19}

' Select the first element in the array.
Dim first As Integer = numbers.First()

' Display the output.
Console.WriteLine(first)

' This code produces the following output:
'
' 9

Remarques

La First<TSource>(IEnumerable<TSource>) méthode lève une exception si source ne contient aucun élément.The First<TSource>(IEnumerable<TSource>) method throws an exception if source contains no elements. Pour retourner à la place une valeur par défaut lorsque la séquence source est vide, utilisez la FirstOrDefault méthode.To instead return a default value when the source sequence is empty, use the FirstOrDefault method.

S’applique à

First<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>)

Retourne le premier élément d’une séquence à satisfaire à la condition spécifiée.Returns the first element in a sequence that satisfies a specified condition.

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

Paramètres de type

TSource

Le type des éléments de source.The type of the elements of source.

Paramètres

source
IEnumerable<TSource>

IEnumerable<T> à partir duquel retourner un élément.An IEnumerable<T> to return an element from.

predicate
Func<TSource,Boolean>

Fonction permettant de tester chaque élément par rapport à une condition.A function to test each element for a condition.

Retours

TSource

Premier élément d'une séquence qui réussit le test dans la fonction de prédicat spécifiée.The first element in the sequence that passes the test in the specified predicate function.

Exceptions

ArgumentNullException

source ou predicate est null.source or predicate is null.

InvalidOperationException

Aucun élément ne satisfait la condition dans predicate.No element satisfies the condition in predicate.

- ou --or- La séquence source est vide.The source sequence is empty.

Exemples

L’exemple de code suivant montre comment utiliser First<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) pour retourner le premier élément d’un tableau qui satisfait à une condition.The following code example demonstrates how to use First<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) to return the first element of an array that satisfies a condition.

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

int first = numbers.First(number => number > 80);

Console.WriteLine(first);

/*
 This code produces the following output:

 92
*/

' Create an array of integers.
Dim numbers() As Integer =
{9, 34, 65, 92, 87, 435, 3, 54, 83, 23, 87, 435, 67, 12, 19}

' Select the first element in the array whose value is greater than 80.
Dim first As Integer = numbers.First(Function(number) number > 80)

' Display the output.
Console.WriteLine(first)

' This code produces the following output:
'
' 92

Remarques

La First<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) méthode lève une exception si aucun élément correspondant n’est trouvé dans source .The First<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) method throws an exception if no matching element is found in source. Pour retourner à la place une valeur par défaut quand aucun élément correspondant n’est trouvé, utilisez la FirstOrDefault méthode.To instead return a default value when no matching element is found, use the FirstOrDefault method.

S’applique à