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 Queryable.FirstOrDefault<TSource> (IQueryable<TSource>)

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 IQueryable<TSource> source
)

Parametri di tipo

TSource

Tipo degli elementi di source.

Parametri

source
Tipo: System.Linq.IQueryable<TSource>
Oggetto IQueryable<T> di cui restituire il primo elemento.

Valore restituito

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

Nota sull'utilizzo

In Visual Basic e C# è possibile chiamare questo metodo come metodo di istanza su qualsiasi oggetto di tipo IQueryable<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

source è null.

Il metodo FirstOrDefault<TSource>(IQueryable<TSource>) genera un oggetto MethodCallExpression che rappresenta una chiamata al metodo FirstOrDefault<TSource>(IQueryable<TSource>) stesso come un metodo generico costruito. Passa quindi MethodCallExpression al metodo Execute<TResult>(Expression) di IQueryProvider rappresentato dalla proprietà Provider del parametro source.

Il comportamento della query conseguente all'esecuzione di una struttura ad albero dell'espressione che rappresenta una chiamata a FirstOrDefault<TSource>(IQueryable<TSource>) dipende dall'implementazione del tipo del parametro source. In base al comportamento previsto, viene restituito il primo elemento nell’oggetto source o un valore predefinito se l’oggetto source è vuoto.

Il metodo FirstOrDefault non consente di specificare il valore predefinito da restituire se source è vuoto. Se si desidera specificare un valore predefinito diverso da default(TSource), utilizzare il metodo DefaultIfEmpty<TSource>(IQueryable<TSource>, TSource) come descritto nella sezione Esempio.

Nell'esempio di codice riportato di seguito viene illustrato come utilizzare FirstOrDefault<TSource>(IQueryable<TSource>) su una sequenza vuota.


            // Create an empty array.
            int[] numbers = { };
            // Get the first item in the array, or else the 
            // default value for type int (0).
            int first = numbers.AsQueryable().FirstOrDefault();

            Console.WriteLine(first);

            /*
                This code produces the following output:

                0
            */



Talvolta il valore di default(TSource) non è il valore predefinito che si desidera utilizzare se la raccolta non contiene elementi. Anziché controllare il risultato per verificare la presenza del valore predefinito non desiderato e quindi modificarlo se necessario, è possibile utilizzare il metodo DefaultIfEmpty<TSource>(IQueryable<TSource>, TSource) per specificare il valore predefinito che si desidera utilizzare se la raccolta è vuota. Chiamare quindi First<TSource>(IQueryable<TSource>) per ottenere il primo elemento. Nell'esempio di codice seguente vengono utilizzate entrambe le tecniche per ottenere 1 come valore predefinito se una raccolta di mesi numerici è vuota. Poiché il valore predefinito per un numero intero è 0, valore che non corrisponde ad alcun mese, è necessario specificare 1 come valore predefinito. Al completamento della query, viene controllata la prima variabile del risultato per verificare la presenza del valore predefinito non desiderato. La seconda variabile del risultato viene ottenuta chiamando DefaultIfEmpty<TSource>(IQueryable<TSource>, TSource) per specificare 1 come valore predefinito.


            List<int> months = new List<int> { };

            // Setting the default value to 1 after the query.
            int firstMonth1 = months.AsQueryable().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.AsQueryable().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
            */



.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
Microsoft sta conducendo un sondaggio in linea per comprendere l'opinione degli utenti in merito al sito Web di MSDN. Se si sceglie di partecipare, quando si lascia il sito Web di MSDN verrà visualizzato il sondaggio in linea.

Si desidera partecipare?
Mostra:
© 2014 Microsoft