Enumerable.First Méthode

Définition

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

Surcharges

First<TSource>(IEnumerable<TSource>)

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

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

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

First<TSource>(IEnumerable<TSource>)

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

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.

Paramètres

source
IEnumerable<TSource>

IEnumerable<T> duquel retourner le premier élément.

Retours

TSource

Premier élément de la séquence spécifiée.

Exceptions

source a la valeur null.

La séquence source est vide.

Exemples

L’exemple de code suivant montre comment utiliser First<TSource>(IEnumerable<TSource>) pour retourner le premier élément d’un tableau.

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. Pour retourner une valeur par défaut lorsque la séquence source est vide, utilisez la FirstOrDefault méthode .

S’applique à

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

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

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.

Paramètres

source
IEnumerable<TSource>

IEnumerable<T> à partir duquel retourner un élément.

predicate
Func<TSource,Boolean>

Fonction permettant de tester chaque élément par rapport à une condition.

Retours

TSource

Premier élément d'une séquence qui réussit le test dans la fonction de prédicat spécifiée.

Exceptions

source ou predicate est null.

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

- ou -

La séquence source est vide.

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.

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. Pour retourner une valeur par défaut lorsqu’aucun élément correspondant n’est trouvé, utilisez la FirstOrDefault méthode .

S’applique à