Enumerable.First Méthode
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Retourne le premier élément d'une séquence.
| 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. |
- Source:
- First.cs
- Source:
- First.cs
- Source:
- First.cs
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 TSourceParamè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
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 à
.NET 9 et autres versions
| Produit | Versions |
|---|---|
| .NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
| .NET Framework | 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1 |
| UWP | 10.0 |
- Source:
- First.cs
- Source:
- First.cs
- Source:
- First.cs
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 TSourceParamètres de type
- TSource
Le type des éléments de source.
Paramètres
- source
- IEnumerable<TSource>
IEnumerable<T> à partir duquel retourner un élément.
Fonction permettant de tester chaque élément par rapport à une condition.
Retours
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 répond à 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 à
.NET 9 et autres versions
| Produit | Versions |
|---|---|
| .NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
| .NET Framework | 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1 |
| UWP | 10.0 |
Commentaires sur .NET
.NET est un projet open source. Sélectionnez un lien pour fournir des commentaires: