Metodo Enumerable.Single<TSource> (IEnumerable<TSource>)

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

Nota sull'utilizzo

Se la sequenza di input è vuota, il metodo Single<TSource>(IEnumerable<TSource>) genera un’eccezione. Per restituire invece null quando la sequenza di input è vuota, utilizzare SingleOrDefault.

Nell'esempio di codice riportato di seguito viene illustrato come utilizzare l'oggetto Single<TSource>(IEnumerable<TSource>) per selezionare il singolo elemento di una matrice.

            string[] fruits1 = { "orange" };

            string fruit1 = fruits1.Single();

            Console.WriteLine(fruit1);

            /*
             This code produces the following output:

             orange
            */

Nell'esempio di codice riportato di seguito viene dimostrato che Single<TSource>(IEnumerable<TSource>) genera un'eccezione quando la sequenza non contiene esattamente un elemento.

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

.NET Framework

.NET Framework Client Profile

Libreria di classi portabile

.NET per applicazioni Windows Store

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (ruoli di base del server non supportati), Windows Server 2008 R2 (ruoli di base del server supportati con SP1 o versione successiva, Itanium non supportato)

Riferimenti