Enumerable.FirstOrDefault Méthode

Définition

Espace de noms:

System.Linq

Assembly:

System.Linq.dll

Retourne le premier élément d'une séquence ou une valeur par défaut si aucun élément n'est trouvé.

Surcharges

FirstOrDefault<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>, TSource)	Retourne le premier élément de la séquence qui remplit une condition, ou une valeur par défaut spécifiée si aucun élément de ce type n’est trouvé.
FirstOrDefault<TSource>(IEnumerable<TSource>, TSource)	Retourne le premier élément d’une séquence ou une valeur par défaut spécifiée si la séquence ne contient aucun élément.
FirstOrDefault<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>)	Retourne le premier élément de la séquence à satisfaire à une condition ou une valeur par défaut si aucun élément correspondant n’est trouvé.
FirstOrDefault<TSource>(IEnumerable<TSource>)	Retourne le premier élément d’une séquence ou une valeur par défaut si la séquence ne contient aucun élément.

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

Retourne le premier élément de la séquence qui remplit une condition, ou une valeur par défaut spécifiée si aucun élément de ce type n’est trouvé.

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static TSource FirstOrDefault(System::Collections::Generic::IEnumerable<TSource> ^ source, Func<TSource, bool> ^ predicate, TSource defaultValue);

public static TSource FirstOrDefault<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,bool> predicate, TSource defaultValue);

static member FirstOrDefault : seq<'Source> * Func<'Source, bool> * 'Source -> 'Source

<Extension()>
Public Function FirstOrDefault(Of TSource) (source As IEnumerable(Of TSource), predicate As Func(Of TSource, Boolean), defaultValue As TSource) 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.

defaultValue

TSource

Valeur par défaut à retourner si la séquence est vide.

Retours

TSource

defaultValue si source est vide ou si aucun élément ne réussit le test spécifié par predicate; sinon, le premier élément dans source qui réussit le test spécifié par predicate.

Exceptions

ArgumentNullException

source ou predicate est null.

FirstOrDefault<TSource>(IEnumerable<TSource>, TSource)

Retourne le premier élément d’une séquence ou une valeur par défaut spécifiée si la séquence ne contient aucun élément.

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static TSource FirstOrDefault(System::Collections::Generic::IEnumerable<TSource> ^ source, TSource defaultValue);

public static TSource FirstOrDefault<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, TSource defaultValue);

static member FirstOrDefault : seq<'Source> * 'Source -> 'Source

<Extension()>
Public Function FirstOrDefault(Of TSource) (source As IEnumerable(Of TSource), defaultValue As 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.

defaultValue

TSource

Valeur par défaut à retourner si la séquence est vide.

Retours

TSource

defaultValue si source est vide ; sinon, le premier élément dans source.

Exceptions

ArgumentNullException

source a la valeur null.

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

Retourne le premier élément de la séquence à satisfaire à une condition ou une valeur par défaut si aucun élément correspondant n’est trouvé.

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static TSource FirstOrDefault(System::Collections::Generic::IEnumerable<TSource> ^ source, Func<TSource, bool> ^ predicate);

public static TSource? FirstOrDefault<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,bool> predicate);

static member FirstOrDefault : seq<'Source> * Func<'Source, bool> -> 'Source

<Extension()>
Public Function FirstOrDefault(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

default (TSource) si source est vide ou si aucun élément ne réussit le test spécifié par predicate ; sinon, le premier élément de source qui réussit le test spécifié par predicate.

Exceptions

ArgumentNullException

source ou predicate est null.

Exemples

L’exemple de code suivant montre comment utiliser FirstOrDefault<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) en passant un prédicat. Dans le deuxième appel à la méthode, il n’existe aucun élément dans le tableau qui remplit la condition.

string[] names = { "Hartono, Tommy", "Adams, Terry",
                     "Andersen, Henriette Thaulow",
                     "Hedlund, Magnus", "Ito, Shu" };

string firstLongName = names.FirstOrDefault(name => name.Length > 20);

Console.WriteLine("The first long name is '{0}'.", firstLongName);

string firstVeryLongName = names.FirstOrDefault(name => name.Length > 30);

Console.WriteLine(
    "There is {0} name longer than 30 characters.",
    string.IsNullOrEmpty(firstVeryLongName) ? "not a" : "a");

/*
 This code produces the following output:

 The first long name is 'Andersen, Henriette Thaulow'.
 There is not a name longer than 30 characters.
*/

' Create an array of strings.
Dim names() As String =
{"Hartono, Tommy", "Adams, Terry", "Andersen, Henriette Thaulow", "Hedlund, Magnus", "Ito, Shu"}

' Select the first string in the array whose length is greater than 20.
Dim firstLongName As String =
names.FirstOrDefault(Function(name) name.Length > 20)

' Display the output.
Console.WriteLine($"The first long name is {firstLongName}")

' Select the first string in the array whose length is greater than 30,
' or a default value if there are no such strings in the array.
Dim firstVeryLongName As String =
names.FirstOrDefault(Function(name) name.Length > 30)

Dim text As String = IIf(String.IsNullOrEmpty(firstVeryLongName), "not a", "a")

Console.WriteLine($"There is {text} name longer than 30 characters.")

' This code produces the following output:
'
' The first long name is Andersen, Henriette Thaulow
'
' There is not a name longer than 30 characters.

Remarques

La valeur par défaut pour les types de référence et nullables est null.

FirstOrDefault<TSource>(IEnumerable<TSource>)

Retourne le premier élément d’une séquence ou une valeur par défaut si la séquence ne contient aucun élément.

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static TSource FirstOrDefault(System::Collections::Generic::IEnumerable<TSource> ^ source);

public static TSource? FirstOrDefault<TSource> (this System.Collections.Generic.IEnumerable<TSource> source);

static member FirstOrDefault : seq<'Source> -> 'Source

<Extension()>
Public Function FirstOrDefault(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

default (TSource) si source est vide ; sinon, le premier élément de source.

Exceptions

ArgumentNullException

source a la valeur null.

Exemples

L’exemple de code suivant montre comment utiliser FirstOrDefault<TSource>(IEnumerable<TSource>) sur un tableau vide.

int[] numbers = { };
int first = numbers.FirstOrDefault();
Console.WriteLine(first);

/*
 This code produces the following output:

 0
*/

' Create an empty array.
Dim numbers() As Integer = {}

' Select the first element in the array, or a default value
' if there are not elements in the array.
Dim first As Integer = numbers.FirstOrDefault()

' Display the output.
Console.WriteLine(first)

' This code produces the following output:
'
' 0

Parfois, la valeur de n’est default(TSource) pas la valeur par défaut que vous souhaitez utiliser si la collection ne contient aucun élément. Au lieu de vérifier le résultat pour la valeur par défaut indésirable et de la modifier si nécessaire, vous pouvez utiliser la DefaultIfEmpty<TSource>(IEnumerable<TSource>, TSource) méthode pour spécifier la valeur par défaut que vous souhaitez utiliser si la collection est vide. Ensuite, appelez First<TSource>(IEnumerable<TSource>) pour obtenir le premier élément. L’exemple de code suivant utilise les deux techniques pour obtenir une valeur par défaut de 1 si une collection de mois numériques est vide. Étant donné que la valeur par défaut d’un entier est 0, ce qui ne correspond à aucun mois, la valeur par défaut doit être spécifiée comme 1 à la place. La première variable de résultat est vérifiée pour la valeur par défaut indésirable une fois l’exécution de la requête terminée. La deuxième variable de résultat est obtenue à l’aide DefaultIfEmpty<TSource>(IEnumerable<TSource>, TSource) de pour spécifier une valeur par défaut de 1.

List<int> months = new List<int> { };

// Setting the default value to 1 after the query.
int firstMonth1 = months.FirstOrDefault();
if (firstMonth1 == 0)
{
    firstMonth1 = 1;
}
Console.WriteLine("The value of the firstMonth1 variable is {0}", firstMonth1);

// Setting the default value to 1 by using DefaultIfEmpty() in the query.
int firstMonth2 = months.DefaultIfEmpty(1).First();
Console.WriteLine("The value of the firstMonth2 variable is {0}", firstMonth2);

/*
 This code produces the following output:

 The value of the firstMonth1 variable is 1
 The value of the firstMonth2 variable is 1
*/

Dim months As New List(Of Integer)(New Integer() {})

' Setting the default value to 1 after the query.
Dim firstMonth1 As Integer = months.FirstOrDefault()
If firstMonth1 = 0 Then
    firstMonth1 = 1
End If
Console.WriteLine($"The value of the firstMonth1 variable is {firstMonth1}")

' Setting the default value to 1 by using DefaultIfEmpty() in the query.
Dim firstMonth2 As Integer = months.DefaultIfEmpty(1).First()
Console.WriteLine($"The value of the firstMonth2 variable is {firstMonth2}")

' This code produces the following output:
'
' The value of the firstMonth1 variable is 1
' The value of the firstMonth2 variable is 1

Remarques

La valeur par défaut pour les types de référence et nullables est null.

La FirstOrDefault méthode ne permet pas de spécifier une valeur par défaut. Si vous souhaitez spécifier une valeur par défaut autre que default(TSource), utilisez la DefaultIfEmpty<TSource>(IEnumerable<TSource>, TSource) méthode comme décrit dans la section Exemple.