Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

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

 

Data di pubblicazione: ottobre 2016

Restituisce il primo elemento di una sequenza o un valore predefinito se la sequenza non contiene elementi.

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

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

Parametri

source
Type: System.Collections.Generic.IEnumerable<TSource>

Il IEnumerable<T> per restituire il primo elemento.

Valore restituito

Type: TSource

default(TSource) se source è vuota; in caso contrario, il primo elemento in source.

Parametri tipo

TSource

Tipo degli elementi di source.

Exception Condition
ArgumentNullException

source è null.

Il valore predefinito per riferimento e tipi nullable è null.

Il FirstOrDefault metodo non fornisce un modo per specificare un valore predefinito. Se si desidera specificare un valore predefinito diverso da default(TSource), utilizzare il DefaultIfEmpty<TSource>(IEnumerable<TSource>, TSource) metodo come descritto nella sezione esempio.

Esempio di codice seguente viene illustrato come utilizzare FirstOrDefault<TSource>(IEnumerable<TSource>) su una matrice vuota.

int[] numbers = { };
int first = numbers.FirstOrDefault();
Console.WriteLine(first);

/*
 This code produces the following output:

 0
*/

In alcuni casi il valore di default(TSource) non è il valore predefinito che si desidera utilizzare se la raccolta non contiene elementi. Anziché verificare il risultato per il valore predefinito non desiderato e quindi modificarlo se necessario, è possibile utilizzare il DefaultIfEmpty<TSource>(IEnumerable<TSource>, TSource) per specificare il valore predefinito che si desidera utilizzare se la raccolta è vuota. Quindi, chiamare First<TSource>(IEnumerable<TSource>) per ottenere il primo elemento. Esempio di codice seguente utilizza entrambe le tecniche per ottenere un valore predefinito di 1, se un insieme di mesi numerici è vuoto. Perché il valore predefinito per un numero intero è 0, che non corrisponde a un mese, il valore predefinito deve essere invece specificato come 1. La prima variabile di risultato viene verificata per il valore predefinito non desiderato dopo la query ha terminato l'esecuzione. La seconda variabile del risultato viene ottenuta utilizzando DefaultIfEmpty<TSource>(IEnumerable<TSource>, TSource) per specificare un valore predefinito di 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
*/

Universal Windows Platform
Disponibile da 8
.NET Framework
Disponibile da 3.5
Libreria di classi portabile
Supportato in: piattaforme .NET portabili
Silverlight
Disponibile da 2.0
Windows Phone Silverlight
Disponibile da 7.0
Windows Phone
Disponibile da 8.1
Torna all'inizio
Mostra: