Queryable.First Metodo

Definizione

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

Overload

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>>)

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>)

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>

Oggetto IQueryable<T> di cui restituire il primo elemento.The IQueryable<T> to return the first element of.

Restituisce

TSource

Il primo elemento in source.The first element in source.

Eccezioni

source è null.source is null.

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

Esempio

Nell'esempio di codice riportato di seguito viene illustrato come utilizzare First<TSource>(IQueryable<TSource>) per restituire il primo elemento di 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 oggetto MethodCallExpression che rappresenta la chiamata a First<TSource>(IQueryable<TSource>) se stesso come 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 al MethodCallExpression Execute<TResult>(Expression) metodo dell'oggetto IQueryProvider rappresentato dalla 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 della query che si verifica in seguito all'esecuzione di un albero delle espressioni che rappresenta la chiamata First<TSource>(IQueryable<TSource>) dipende dall'implementazione del tipo di 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.

Si applica a

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>

Oggetto 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

Il primo elemento in source che passa il test rispetto a 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.

Esempio

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.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 di tipo è uno dei 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 un'espressione lambda che verrà compilata in un oggetto 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 oggetto MethodCallExpression che rappresenta la chiamata a First<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>) se stesso come 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 al MethodCallExpression Execute<TResult>(Expression) metodo dell'oggetto IQueryProvider rappresentato dalla 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 della query che si verifica in seguito all'esecuzione di un albero delle espressioni che rappresenta la chiamata First<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>) dipende dall'implementazione del tipo di 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 di source che soddisfa la condizione specificata da predicate .The expected behavior is that it returns the first element in source that satisfies the condition specified by predicate.

Si applica a