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
Questo argomento non è stato ancora valutato - Valuta questo argomento

Metodo Queryable.First<TSource> (IQueryable<TSource>, Expression<Func<TSource, Boolean>>)

Restituisce il primo elemento di una sequenza che soddisfa una condizione specificata.

Spazio dei nomi:  System.Linq
Assembly:  System.Core (in System.Core.dll)
public static TSource First<TSource>(
	this IQueryable<TSource> source,
	Expression<Func<TSource, bool>> predicate
)

Parametri di tipo

TSource

Tipo degli elementi di source.

Parametri

source
Tipo: System.Linq.IQueryable<TSource>
Oggetto IQueryable<T> dal quale restituire un elemento.
predicate
Tipo: System.Linq.Expressions.Expression<Func<TSource, Boolean>>
Funzione per testare ogni elemento rispetto a una condizione.

Valore restituito

Tipo: TSource
Il primo elemento in source che passa il test rispetto a predicate.

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) oppure Metodi di estensione (Guida per programmatori C#).
EccezioneCondizione
ArgumentNullException

source o predicate è null.

InvalidOperationException

Nessun elemento soddisfa la condizione in predicate.

o

La sequenza di origine è vuota.

Nel metodo è presente almeno un parametro di tipo Expression<TDelegate> il cui argomento di tipo è costituito da uno dei tipi Func<T, TResult>. Per questi parametri è possibile passare un'espressione lambda che verrà compilata in un oggetto Expression<TDelegate>.

Il metodo First<TSource>(IQueryable<TSource>, Expression<Func<TSource, Boolean>>) genera un oggetto MethodCallExpression che rappresenta una chiamata al metodo First<TSource>(IQueryable<TSource>, Expression<Func<TSource, Boolean>>) 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 First<TSource>(IQueryable<TSource>, Expression<Func<TSource, Boolean>>) dipende dall'implementazione del tipo del parametro source. In base al comportamento previsto, viene restituito il primo elemento in source che soddisfa la condizione specificata da predicate.

Nell'esempio di codice riportato di seguito viene illustrato come utilizzare First<TSource>(IQueryable<TSource>, Expression<Func<TSource, Boolean>>) per restituire il primo elemento di una sequenza che soddisfa una condizione.


            int[] numbers = { 9, 34, 65, 92, 87, 435, 3, 54, 
                              83, 23, 87, 435, 67, 12, 19 };

            // Get the first number in the array that is greater than 80.
            int first = numbers.AsQueryable().First(number => number > 80);

            Console.WriteLine(first);

            /*
                This code produces the following output:

                92
            */



.NET Framework

Supportato in: 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

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.
Il documento è risultato utile?
(1500 caratteri rimanenti)
Grazie per i commenti inviati.

Aggiunte alla community

AGGIUNGI
Mostra:
© 2014 Microsoft. Tutti i diritti riservati.