Queryable.First Метод

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

Параметры типа

Параметры

Возвращаемое значение

TSource

Первый элемент последовательности source.The first element in source.

Исключения

Примеры

В следующем примере кода показано, как использовать First<TSource>(IQueryable<TSource>) для возврата первого элемента последовательности.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

Комментарии

First<TSource>(IQueryable<TSource>)Метод создает объект MethodCallExpression , который представляет вызов First<TSource>(IQueryable<TSource>) самого себя как сконструированного универсального метода.The First<TSource>(IQueryable<TSource>) method generates a MethodCallExpression that represents calling First<TSource>(IQueryable<TSource>) itself as a constructed generic method. Затем он передает MethodCallExpression Execute<TResult>(Expression) методу класса, IQueryProvider представленного Provider свойством source параметра.It then passes the MethodCallExpression to the Execute<TResult>(Expression) method of the IQueryProvider represented by the Provider property of the source parameter.

Поведение запроса, которое происходит в результате выполнения дерева выражения, представляющего вызов, First<TSource>(IQueryable<TSource>) зависит от реализации типа source параметра.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. Ожидаемое поведение заключается в том, что он возвращает первый элемент в source .The expected behavior is that it returns the first element in source.

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

Параметры типа

Параметры

Возвращаемое значение

TSource

Первый элемент последовательности source, прошедший проверку с помощью предиката predicate.The first element in source that passes the test in predicate.

Исключения

Примеры

В следующем примере кода показано, как использовать First<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>) для возврата первого элемента последовательности, удовлетворяющей условию.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

Комментарии

Этот метод имеет по крайней мере один параметр типа Expression<TDelegate> , аргумент типа которого является одним из Func<T,TResult> типов.This method has at least one parameter of type Expression<TDelegate> whose type argument is one of the Func<T,TResult> types. Для этих параметров можно передать лямбда-выражение, которое будет скомпилировано в Expression<TDelegate> .For these parameters, you can pass in a lambda expression and it will be compiled to an Expression<TDelegate>.

First<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>)Метод создает объект MethodCallExpression , который представляет вызов First<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>) самого себя как сконструированного универсального метода.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. Затем он передает MethodCallExpression Execute<TResult>(Expression) методу класса, IQueryProvider представленного Provider свойством source параметра.It then passes the MethodCallExpression to the Execute<TResult>(Expression) method of the IQueryProvider represented by the Provider property of the source parameter.

Поведение запроса, которое происходит в результате выполнения дерева выражения, представляющего вызов, First<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>) зависит от реализации типа source параметра.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. Ожидаемое поведение заключается в том, что он возвращает первый элемент в source , удовлетворяющий условию, заданному параметром predicate .The expected behavior is that it returns the first element in source that satisfies the condition specified by predicate.