Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

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

 

Retourne l'élément unique d'une séquence ou lève une exception si cette séquence ne contient pas un seul et unique élément.

Espace de noms:   System.Linq
Assembly:  System.Core (dans System.Core.dll)

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

Paramètres

source

IEnumerable<T> duquel retourner le seul élément.

Valeur de retour

Type: TSource

Seul élément de la séquence d'entrée.

Paramètres de type

TSource

Type des éléments de source.

Exception Condition
ArgumentNullException

source a la valeur null.

InvalidOperationException

La séquence d'entrée contient plusieurs éléments.

ou

La séquence d'entrée est vide.

La méthode Single<TSource>(IEnumerable<TSource>) lève une exception si la séquence d'entrée est vide.Pour retourner une valeur null à la place lorsque la séquence d'entrée est vide, utilisez la méthode SingleOrDefault<TSource>.

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

string[] fruits1 = { "orange" };

string fruit1 = fruits1.Single();

Console.WriteLine(fruit1);

/*
 This code produces the following output:

 orange
*/

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

string[] fruits2 = { "orange", "apple" };
string fruit2 = null;

try
{
    fruit2 = fruits2.Single();
}
catch (System.InvalidOperationException)
{
    Console.WriteLine("The collection does not contain exactly one element.");
}

Console.WriteLine(fruit2);

/*
 This code produces the following output:

 The collection does not contain exactly one element.
*/

Universal Windows Platform
Disponible depuis 4.5
.NET Framework
Disponible depuis 3.5
Portable Class Library
Pris en charge dans : portable .NET platforms
Silverlight
Disponible depuis 2.0
Windows Phone Silverlight
Disponible depuis 7.0
Windows Phone
Disponible depuis 8.1
Retour au début
Afficher: