Enumerable.FirstOrDefault<TSource>, méthode (IEnumerable<TSource>)

public static TSource FirstOrDefault<TSource>(
	this IEnumerable<TSource> source
)

Remarque sur l'utilisation

La valeur par défaut des types référence et Nullable est null.

La méthode FirstOrDefault n'offre pas de moyen de spécifier une valeur par défaut. Si vous souhaitez spécifier une valeur par défaut différente de default(TSource), utilisez la méthode DefaultIfEmpty<TSource>(IEnumerable<TSource>, TSource) décrite dans la section Exemple.

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
            */

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 non voulue, puis de la modifier si nécessaire, vous pouvez utiliser la méthode DefaultIfEmpty<TSource>(IEnumerable<TSource>, TSource) pour spécifier la valeur par défaut que vous souhaitez utiliser si la collection est vide. Puis 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 en chiffres est vide. Étant donné que la valeur par défaut pour un entier est 0 et que cela ne correspond à aucun mois, la valeur par défaut doit alors être définie sur 1. La première variable de résultat est vérifiée pour la valeur par défaut non voulue après l'exécution de la requête. La deuxième variable de résultat est obtenue en utilisant DefaultIfEmpty<TSource>(IEnumerable<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.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
            */

.NET Framework

.NET Framework Client Profile

Bibliothèque de classes portable

.NET pour les applications du Windows Store

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Référence