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 Queryable.FirstOrDefault<TSource>(IQueryable<TSource>, Expression<Func<TSource, Boolean>>)

 

Data di pubblicazione: ottobre 2016

Restituisce il primo elemento di una sequenza che soddisfa una condizione specificata o un valore predefinito se tale elemento non viene trovato.

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

public static TSource FirstOrDefault<TSource>(
	this IQueryable<TSource> source,
	Expression<Func<TSource, bool>> predicate
)

Parametri

source
Type: System.Linq.IQueryable<TSource>

Un IQueryable<T> per restituire un elemento.

predicate
Type: System.Linq.Expressions.Expression<Func<TSource, Boolean>>

Funzione per testare ogni elemento rispetto a una condizione.

Valore restituito

Type: TSource

default(TSource) se source è vuoto o se nessun elemento supera il test specificato dal predicate; in caso contrario, il primo elemento source che supera il test specificato da predicate.

Parametri tipo

TSource

Tipo degli elementi di source.

Exception Condition
ArgumentNullException

source o predicate è null.

Questo metodo contiene almeno un parametro di tipo Expression<TDelegate> il cui argomento di tipo è uno del Func<T, TResult> tipi. Per questi parametri, è possibile passare un'espressione lambda e verrà compilato in un Expression<TDelegate>.

Il FirstOrDefault<TSource>(IQueryable<TSource>, Expression<Func<TSource, Boolean>>) metodo genera un MethodCallExpression che rappresenta una chiamata FirstOrDefault<TSource>(IQueryable<TSource>, Expression<Func<TSource, Boolean>>) stesso come un metodo generico costruito. Passa quindi il MethodCallExpression per il Execute<TResult>(Expression) metodo il IQueryProvider rappresentato dal Provider proprietà del source parametro.

Il comportamento della query che si verifica in seguito all'esecuzione di una struttura ad albero dell'espressione che rappresenta una chiamata FirstOrDefault<TSource>(IQueryable<TSource>, Expression<Func<TSource, Boolean>>) dipende dall'implementazione del tipo di source parametro. Il comportamento previsto è che restituisce il primo elemento source che soddisfa la condizione in predicate, o un valore predefinito se nessun elemento soddisfa la condizione.

Esempio di codice seguente viene illustrato come utilizzare FirstOrDefault<TSource>(IQueryable<TSource>, Expression<Func<TSource, Boolean>>) passando un predicato. Nella seconda query, non è presente alcun elemento nella sequenza che soddisfa la condizione.

string[] names = { "Hartono, Tommy", "Adams, Terry", 
                     "Andersen, Henriette Thaulow", 
                     "Hedlund, Magnus", "Ito, Shu" };

// Get the first string in the array that is longer
// than 20 characters, or the default value for type
// string (null) if none exists.
string firstLongName =
    names.AsQueryable().FirstOrDefault(name => name.Length > 20);

Console.WriteLine("The first long name is '{0}'.", firstLongName);

// Get the first string in the array that is longer
// than 30 characters, or the default value for type
// string (null) if none exists.
string firstVeryLongName =
    names.AsQueryable().FirstOrDefault(name => name.Length > 30);

Console.WriteLine(
    "There is {0} name that is longer than 30 characters.",
    string.IsNullOrEmpty(firstVeryLongName) ? "NOT a" : "a");

/*
    This code produces the following output:

    The first long name is 'Andersen, Henriette Thaulow'.
    There is NOT a name that is longer than 30 characters.
*/

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.1
Windows Phone
Disponibile da 8.1
Torna all'inizio
Mostra: