Queryable.FirstOrDefault Méthode

Définition

Espace de noms:

System.Linq

Assembly:

System.Linq.Queryable.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>(IQueryable<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>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>)	Retourne le premier élément d'une séquence qui satisfait à une condition spécifiée ou une valeur par défaut si aucun élément ne correspond.
FirstOrDefault<TSource>(IQueryable<TSource>, 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>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, TSource)	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>(IQueryable<TSource>)

Source:

Queryable.cs

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::Linq::IQueryable<TSource> ^ source);

public static TSource? FirstOrDefault<TSource> (this System.Linq.IQueryable<TSource> source);

static member FirstOrDefault : System.Linq.IQueryable<'Source> -> 'Source

<Extension()>
Public Function FirstOrDefault(Of TSource) (source As IQueryable(Of TSource)) As TSource

Paramètres de type

TSource

Le type des éléments de source.

Paramètres

source

IQueryable<TSource>

IQueryable<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>(IQueryable<TSource>) sur une séquence vide.

// Create an empty array.
int[] numbers = { };
// Get the first item in the array, or else the
// default value for type int (0).
int first = numbers.AsQueryable().FirstOrDefault();

Console.WriteLine(first);

/*
    This code produces the following output:

    0
*/

' Create an empty array.
Dim numbers() As Integer = {}
' Get the first item in the array, or else the 
' default value for type int, which is 0.
Dim first As Integer = numbers.AsQueryable().FirstOrDefault()

MsgBox(first)

' This code produces the following output:

' 0

Parfois, la valeur de default(TSource) n’est 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 de la valeur par défaut indésirable et de la modifier si nécessaire, vous pouvez utiliser la DefaultIfEmpty<TSource>(IQueryable<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>(IQueryable<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, qui ne correspond à aucun mois, la valeur par défaut doit être spécifiée sous la forme 1 à la place. La première variable de résultat est vérifiée pour la valeur par défaut indésirable une fois la requête terminée. La deuxième variable de résultat est obtenue en appelant DefaultIfEmpty<TSource>(IQueryable<TSource>, TSource) 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.AsQueryable().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.AsQueryable().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.AsQueryable().FirstOrDefault()
If firstMonth1 = 0 Then
    firstMonth1 = 1
End If
MsgBox(String.Format("The value of the firstMonth1 variable is {0}", firstMonth1))

' Setting the default value to 1 by using DefaultIfEmpty() in the query.
Dim firstMonth2 As Integer = months.AsQueryable().DefaultIfEmpty(1).First()
MsgBox(String.Format("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

Remarques

La FirstOrDefault<TSource>(IQueryable<TSource>) méthode génère un MethodCallExpression qui représente l’appel FirstOrDefault<TSource>(IQueryable<TSource>) de lui-même en tant que méthode générique construite. Il passe ensuite le MethodCallExpression à la Execute<TResult>(Expression) méthode du IQueryProvider représenté par la Provider propriété du source paramètre .

Le comportement de requête qui se produit à la suite de l’exécution d’une arborescence d’expressions qui représente l’appel FirstOrDefault<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, ou une valeur par défaut si source est vide.

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

FirstOrDefault<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 ou une valeur par défaut si aucun élément ne correspond.

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static TSource FirstOrDefault(System::Linq::IQueryable<TSource> ^ source, System::Linq::Expressions::Expression<Func<TSource, bool> ^> ^ predicate);

public static TSource? FirstOrDefault<TSource> (this System.Linq.IQueryable<TSource> source, System.Linq.Expressions.Expression<Func<TSource,bool>> predicate);

static member FirstOrDefault : System.Linq.IQueryable<'Source> * System.Linq.Expressions.Expression<Func<'Source, bool>> -> 'Source

<Extension()>
Public Function FirstOrDefault(Of TSource) (source As IQueryable(Of TSource), predicate As Expression(Of Func(Of TSource, Boolean))) As TSource

Paramètres de type

TSource

Le 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 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>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>) en passant un prédicat. Dans la deuxième requête, aucun élément de la séquence ne remplit la condition.

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

// Get the first string in the array that is longer
// than 20 characters, or the default value for type
// string (null) if none exists.
string firstLongName =
    names.AsQueryable().FirstOrDefault(name => name.Length > 20);

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

// Get the first string in the array that is longer
// than 30 characters, or the default value for type
// string (null) if none exists.
string firstVeryLongName =
    names.AsQueryable().FirstOrDefault(name => name.Length > 30);

Console.WriteLine(
    "There is {0} name that is 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 that is longer than 30 characters.
*/

Dim names() As String = {"Hartono, Tommy", "Adams, Terry", _
                     "Andersen, Henriette Thaulow", _
                     "Hedlund, Magnus", "Ito, Shu"}

' Get the first string in the array that is longer
' than 20 characters, or the default value for type
' string (null) if none exists.
Dim firstLongName As String = _
            names.AsQueryable().FirstOrDefault(Function(name) name.Length > 20)

MsgBox(String.Format("The first long name is '{0}'.", firstLongName))

' Get the first string in the array that is longer
' than 30 characters, or the default value for type
' string (null) if none exists.
Dim firstVeryLongName As String = _
    names.AsQueryable().FirstOrDefault(Function(name) name.Length > 30)

MsgBox(String.Format( _
    "There is {0} name that is longer than 30 characters.", _
    IIf(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 that is longer than 30 characters.

Remarques

Cette méthode a au moins un paramètre de type Expression<TDelegate> dont l’argument type est l’un Func<T,TResult> des types. Pour ces paramètres, vous pouvez passer une expression lambda et elle sera compilée dans un Expression<TDelegate>.

La FirstOrDefault<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>) méthode génère un MethodCallExpression qui représente l’appel FirstOrDefault<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>) de lui-même en tant que méthode générique construite. Il passe ensuite le MethodCallExpression à la Execute<TResult>(Expression) méthode du IQueryProvider représenté par la Provider propriété du source paramètre .

Le comportement de requête qui se produit à la suite de l’exécution d’une arborescence d’expressions qui représente l’appel FirstOrDefault<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 dans source qui remplit la condition dans predicate, ou une valeur par défaut si aucun élément ne remplit la condition.

FirstOrDefault<TSource>(IQueryable<TSource>, TSource)

Source:

Queryable.cs

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::Linq::IQueryable<TSource> ^ source, TSource defaultValue);

public static TSource FirstOrDefault<TSource> (this System.Linq.IQueryable<TSource> source, TSource defaultValue);

static member FirstOrDefault : System.Linq.IQueryable<'Source> * 'Source -> 'Source

<Extension()>
Public Function FirstOrDefault(Of TSource) (source As IQueryable(Of TSource), defaultValue As TSource) As TSource

Paramètres de type

TSource

Le type des éléments de source.

Paramètres

source

IQueryable<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>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, TSource)

Source:

Queryable.cs

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::Linq::IQueryable<TSource> ^ source, System::Linq::Expressions::Expression<Func<TSource, bool> ^> ^ predicate, TSource defaultValue);

public static TSource FirstOrDefault<TSource> (this System.Linq.IQueryable<TSource> source, System.Linq.Expressions.Expression<Func<TSource,bool>> predicate, TSource defaultValue);

static member FirstOrDefault : System.Linq.IQueryable<'Source> * System.Linq.Expressions.Expression<Func<'Source, bool>> * 'Source -> 'Source

<Extension()>
Public Function FirstOrDefault(Of TSource) (source As IQueryable(Of TSource), predicate As Expression(Of Func(Of TSource, Boolean)), defaultValue As TSource) As TSource

Paramètres de type

TSource

Le type des éléments de source.

Paramètres

source

IQueryable<TSource>

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

predicate

Expression<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 de source qui réussit le test spécifié par predicate.

Exceptions

ArgumentNullException

source ou predicate est null.