Questa pagina è stata utile?
I suggerimenti relativi al contenuto di questa pagina sono importanti. Comunicaceli.
Altri suggerimenti?
1500 caratteri rimanenti
Esporta (0) Stampa
Espandi tutto
Il presente articolo è stato tradotto automaticamente. Passare il puntatore sulle frasi nell'articolo per visualizzare il testo originale. Ulteriori informazioni.
Traduzione
Originale

Metodo Enumerable.Single<TSource> (IEnumerable<TSource>, Func<TSource, Boolean>)

Restituisce il singolo elemento di una sequenza che soddisfa una condizione specificata e genera un'eccezione se esiste più di un elemento.

Spazio dei nomi:  System.Linq
Assembly:  System.Core (in System.Core.dll)

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

Parametri di tipo

TSource

Tipo degli elementi di source.

Parametri

source
Tipo: System.Collections.Generic.IEnumerable<TSource>
Oggetto IEnumerable<T> dal quale restituire un singolo elemento.
predicate
Tipo: System.Func<TSource, Boolean>
Funzione per testare un elemento per una condizione.

Valore restituito

Tipo: TSource
Singolo elemento della sequenza di input che soddisfa una condizione.

Nota sull'utilizzo

In Visual Basic e C# è possibile chiamare questo metodo come metodo di istanza su qualsiasi oggetto di tipo IEnumerable<TSource>. Per chiamare il metodo utilizzando la sintassi del metodo di istanza, omettere il primo parametro. Per ulteriori informazioni, vedere Metodi di estensione (Visual Basic) o Metodi di estensione (Guida per programmatori C#).

EccezioneCondizione
ArgumentNullException

Il parametro source o predicate è null.

InvalidOperationException

Nessun elemento soddisfa la condizione in predicate.

-oppure-

Più di un elemento soddisfa la condizione in predicate.

-oppure-

La sequenza di origine è vuota.

Se la sequenza di input non contiene elementi corrispondenti, il metodo Single<TSource>(IEnumerable<TSource>, Func<TSource, Boolean>) genera un’eccezione. Per restituire invece null quando non viene trovato alcun elemento corrispondente, utilizzare SingleOrDefault.

Nell'esempio di codice riportato di seguito viene illustrato come utilizzare Single<TSource>(IEnumerable<TSource>, Func<TSource, Boolean>) per selezionare il singolo elemento di una matrice che soddisfa una condizione.


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



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


            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

Supportato in: 4.5.2, 4.5.1, 4.5, 4, 3.5

.NET Framework Client Profile

Supportato in: 4, 3.5 SP1

Libreria di classi portabile

Supportato in: Libreria di classi portabile

.NET per applicazioni Windows Store

Supportato in: Windows 8

.NET per applicazioni Windows Phone

Supportato in: Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, 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)

.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.

Aggiunte alla community

AGGIUNGI
Mostra:
© 2015 Microsoft