Queryable.First Queryable.First Queryable.First Queryable.First Method

Definizione

Restituisce il primo elemento di una sequenza.Returns the first element of a sequence.

Overload

First<TSource>(IQueryable<TSource>) First<TSource>(IQueryable<TSource>) First<TSource>(IQueryable<TSource>) First<TSource>(IQueryable<TSource>)

Restituisce il primo elemento di una sequenza.Returns the first element of a sequence.

First<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>) First<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>) First<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>) First<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>)

Restituisce il primo elemento di una sequenza che soddisfa una condizione specificata.Returns the first element of a sequence that satisfies a specified condition.

First<TSource>(IQueryable<TSource>) First<TSource>(IQueryable<TSource>) First<TSource>(IQueryable<TSource>) First<TSource>(IQueryable<TSource>)

Restituisce il primo elemento di una sequenza.Returns the first element of a sequence.

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static TSource First(System::Linq::IQueryable<TSource> ^ source);
public static TSource First<TSource> (this System.Linq.IQueryable<TSource> source);
static member First : System.Linq.IQueryable<'Source> -> 'Source
<Extension()>
Public Function First(Of TSource) (source As IQueryable(Of TSource)) As TSource

Parametri di tipo

TSource

Tipo degli elementi di source.The type of the elements of source.

Parametri

source
IQueryable<TSource>

Il IQueryable<T> per restituire il primo elemento.The IQueryable<T> to return the first element of.

Restituisce

TSource TSource TSource TSource

Al primo elemento source.The first element in source.

Eccezioni

La sequenza di origine è vuota.The source sequence is empty.

Esempi

Esempio di codice seguente viene illustrato come utilizzare First<TSource>(IQueryable<TSource>) per restituire il primo elemento in una sequenza.The following code example demonstrates how to use First<TSource>(IQueryable<TSource>) to return the first element in a sequence.

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

int first = numbers.AsQueryable().First();

Console.WriteLine(first);

/*
    This code produces the following output:

    9
*/

Dim numbers() As Integer = {9, 34, 65, 92, 87, 435, 3, 54, _
                    83, 23, 87, 435, 67, 12, 19}

Dim first As Integer = numbers.AsQueryable().First()

MsgBox(first)

' This code produces the following output:
'
' 9

Commenti

Il First<TSource>(IQueryable<TSource>) metodo genera un MethodCallExpression che rappresenta una chiamata First<TSource>(IQueryable<TSource>) stesso come un metodo generico costruito.The First<TSource>(IQueryable<TSource>) method generates a MethodCallExpression that represents calling First<TSource>(IQueryable<TSource>) itself as a constructed generic method. Passa quindi il MethodCallExpression per il Execute<TResult>(Expression) metodo del IQueryProvider rappresentato dal Provider proprietà del source parametro.It then passes the MethodCallExpression to the Execute<TResult>(Expression) method of the IQueryProvider represented by the Provider property of the source parameter.

Il comportamento delle query che si verifica in seguito all'esecuzione di un albero delle espressioni che rappresenta una chiamata First<TSource>(IQueryable<TSource>) dipende dall'implementazione del tipo del source parametro.The query behavior that occurs as a result of executing an expression tree that represents calling First<TSource>(IQueryable<TSource>) depends on the implementation of the type of the source parameter. Il comportamento previsto è che restituisce il primo elemento in source.The expected behavior is that it returns the first element in source.

First<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>) First<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>) First<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>) First<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>)

Restituisce il primo elemento di una sequenza che soddisfa una condizione specificata.Returns the first element of a sequence that satisfies a specified condition.

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static TSource First(System::Linq::IQueryable<TSource> ^ source, System::Linq::Expressions::Expression<Func<TSource, bool> ^> ^ predicate);
public static TSource First<TSource> (this System.Linq.IQueryable<TSource> source, System.Linq.Expressions.Expression<Func<TSource,bool>> predicate);
static member First : System.Linq.IQueryable<'Source> * System.Linq.Expressions.Expression<Func<'Source, bool>> -> 'Source
<Extension()>
Public Function First(Of TSource) (source As IQueryable(Of TSource), predicate As Expression(Of Func(Of TSource, Boolean))) As TSource

Parametri di tipo

TSource

Tipo degli elementi di source.The type of the elements of source.

Parametri

source
IQueryable<TSource>

Un IQueryable<T> dal quale restituire un elemento.An IQueryable<T> to return an element from.

predicate
Expression<Func<TSource,Boolean>>

Funzione per testare ogni elemento rispetto a una condizione.A function to test each element for a condition.

Restituisce

TSource TSource TSource TSource

Il primo elemento nella source che passa il test predicate.The first element in source that passes the test in predicate.

Eccezioni

source o predicate è null.source or predicate is null.

Nessun elemento soddisfa la condizione in predicate.No element satisfies the condition in predicate.

-oppure--or- La sequenza di origine è vuota.The source sequence is empty.

Esempi

Esempio di codice seguente viene illustrato come utilizzare First<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>) per restituire il primo elemento di una sequenza che soddisfa una condizione.The following code example demonstrates how to use First<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>) to return the first element of a sequence that satisfies a condition.

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

Dim numbers() As Integer = {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.
Dim first As Integer = numbers.AsQueryable().First(Function(number) number > 80)

MsgBox(first)

' This code produces the following output:
'
' 92

Commenti

Questo metodo ha almeno un parametro di tipo Expression<TDelegate> il cui argomento tipo è uno del Func<T,TResult> tipi.This method has at least one parameter of type Expression<TDelegate> whose type argument is one of the Func<T,TResult> types. Per questi parametri, è possibile passare in un'espressione lambda e verrà compilata per un Expression<TDelegate>.For these parameters, you can pass in a lambda expression and it will be compiled to an Expression<TDelegate>.

Il First<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>) metodo genera un MethodCallExpression che rappresenta una chiamata First<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>) stesso come un metodo generico costruito.The First<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>) method generates a MethodCallExpression that represents calling First<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>) itself as a constructed generic method. Passa quindi il MethodCallExpression per il Execute<TResult>(Expression) metodo del IQueryProvider rappresentato dal Provider proprietà del source parametro.It then passes the MethodCallExpression to the Execute<TResult>(Expression) method of the IQueryProvider represented by the Provider property of the source parameter.

Il comportamento delle query che si verifica in seguito all'esecuzione di un albero delle espressioni che rappresenta una chiamata First<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>) dipende dall'implementazione del tipo del source parametro.The query behavior that occurs as a result of executing an expression tree that represents calling First<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>) depends on the implementation of the type of the source parameter. Il comportamento previsto è che restituisce il primo elemento nella source che soddisfa la condizione specificata dal predicate.The expected behavior is that it returns the first element in source that satisfies the condition specified by predicate.

Si applica a