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

Определение

Возвращает первый элемент последовательности.Returns the first element of a sequence.

Перегрузки

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

Возвращает первый элемент последовательности.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>>)

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

Возвращает первый элемент последовательности.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

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

TSource

Тип элементов последовательности source.The type of the elements of source.

Параметры

source
IQueryable<TSource>

Объект IQueryable<T>, первый элемент которого требуется возвратить.The IQueryable<T> to return the first element of.

Возвраты

TSource TSource TSource TSource

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

Исключения

Исходная последовательность пуста.The source sequence is empty.

Примеры

В следующем примере кода демонстрируется использование 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.

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

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

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

TSource

Тип элементов последовательности source.The type of the elements of source.

Параметры

source
IQueryable<TSource>

Объект IQueryable<T>, из которого требуется возвратить элемент.An IQueryable<T> to return an element from.

predicate
Expression<Func<TSource,Boolean>>

Функция для проверки каждого элемента на соответствие условию.A function to test each element for a condition.

Возвраты

TSource TSource TSource TSource

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

Исключения

Значение параметра source или predicatenull.source or predicate is null.

Ни один элемент не удовлетворяет условию предиката predicate.No element satisfies the condition in predicate.

-или--or- Исходная последовательность пуста.The source sequence is empty.

Примеры

В следующем примере кода демонстрируется использование 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.

Применяется к