Queryable.FirstOrDefault Méthode

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

Paramètres

Retours

default(TSource) s’il source est vide ; sinon, le premier élément dans source.

Exceptions

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 pour la valeur par défaut indésirable, puis 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 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 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 méthode FirstOrDefault<TSource>(IQueryable<TSource>) génère une MethodCallExpression qui représente l’appel de FirstOrDefault<TSource>(IQueryable<TSource>) elle-même en tant que méthode générique construite. Il transmet ensuite la MethodCallExpression à la méthode Execute<TResult>(Expression) de l'IQueryProvider représentée par la propriété Provider du paramètre source.

Le comportement de requête qui se produit suite à l’exécution d’une arborescence d’expressions qui représente l’appel de FirstOrDefault<TSource>(IQueryable<TSource>) dépend de l’implémentation du type du paramètre source. Le comportement attendu est qu’il retourne le premier élément dans source, ou une valeur par défaut s’il source est vide.

La FirstOrDefault méthode ne permet pas de spécifier la valeur par défaut à retourner si source elle 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.

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

Paramètres

Retours

default(TSource) s’il source est vide ou si aucun élément ne réussit le test spécifié par predicate; sinon, le premier élément dans source celui-ci réussit le test spécifié par predicate.

Exceptions

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, il n’existe aucun élément dans la séquence qui satisfait à 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 de type est l’un des Func<T,TResult> types. Pour ces paramètres, vous pouvez passer une expression lambda et elle sera compilée à un Expression<TDelegate>.

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

Le comportement de requête qui se produit suite à l’exécution d’une arborescence d’expressions qui représente l’appel de FirstOrDefault<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>) dépend de l’implémentation du type du paramètre source. Le comportement attendu est qu’il retourne le premier élément qui source satisfait à la condition dans predicate, ou une valeur par défaut si aucun élément ne satisfait à la condition.