Enumerable.Single<TSource>, méthode (IEnumerable<TSource>, Func<TSource, Boolean>)

public static TSource Single<TSource>(
	this IEnumerable<TSource> source,
	Func<TSource, bool> predicate
)

Remarque sur l'utilisation

La méthode Single<TSource>(IEnumerable<TSource>, Func<TSource, Boolean>) lève une exception si aucun élément correspondant n'est trouvé dans la séquence d'entrée. Pour retourner la valeur null à la place lorsqu'aucun élément correspondant n'est trouvé, utilisez SingleOrDefault.

L'exemple de code suivant montre comment utiliser Single<TSource>(IEnumerable<TSource>, Func<TSource, Boolean>) pour sélectionner le seul élément d'un tableau à satisfaire à une condition.

            string[] fruits = { "apple", "banana", "mango", 
                                  "orange", "passionfruit", "grape" };

            string fruit1 = fruits.Single(fruit => fruit.Length > 10);

            Console.WriteLine(fruit1);

            /*
             This code produces the following output:

             passionfruit
            */

Dans l'exemple de code suivant, Single<TSource>(IEnumerable<TSource>, Func<TSource, Boolean>) lève une exception lorsque la séquence ne contient pas exactement un élément qui satisfasse à la condition.

            string fruit2 = null;

            try
            {
                fruit2 = fruits.Single(fruit => fruit.Length > 15);
            }
            catch (System.InvalidOperationException)
            {
                Console.WriteLine(@"The collection does not contain exactly 
                                one element whose length is greater than 15.");
            }

            Console.WriteLine(fruit2);

            // This code produces the following output:
            //
            // The collection does not contain exactly  
            // one element whose length is greater than 15.

.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