Enumerable.First Enumerable.First Enumerable.First Enumerable.First Method

Определение

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

Перегрузки

First<TSource>(IEnumerable<TSource>) First<TSource>(IEnumerable<TSource>) First<TSource>(IEnumerable<TSource>) First<TSource>(IEnumerable<TSource>)

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

First<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) First<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) First<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) First<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>)

Возвращает первый элемент последовательности, удовлетворяющий указанному условию.Returns the first element in a sequence that satisfies a specified condition.

First<TSource>(IEnumerable<TSource>) First<TSource>(IEnumerable<TSource>) First<TSource>(IEnumerable<TSource>) First<TSource>(IEnumerable<TSource>)

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

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

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

TSource

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

Параметры

source
IEnumerable<TSource>

IEnumerable<T> Для возвращения первого элемента.The IEnumerable<T> to return the first element of.

Возвраты

TSource TSource TSource TSource

Первый элемент указанной последовательности.The first element in the specified sequence.

Исключения

Свойство source имеет значение null.source is null.

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

Примеры

В следующем примере кода демонстрируется использование First<TSource>(IEnumerable<TSource>) для возвращения первого элемента массива.The following code example demonstrates how to use First<TSource>(IEnumerable<TSource>) to return the first element of an array.

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

int first = numbers.First();

Console.WriteLine(first);

/*
 This code produces the following output:

 9
*/
' Create an array of integers.
Dim numbers() As Integer =
{9, 34, 65, 92, 87, 435, 3, 54, 83, 23, 87, 435, 67, 12, 19}

' Select the first element in the array.
Dim first As Integer = numbers.First()

' Display the output.
MsgBox(first)

' This code produces the following output:
'
' 9

Комментарии

First<TSource>(IEnumerable<TSource>) Метод вызывает исключение, если source не содержит элементов.The First<TSource>(IEnumerable<TSource>) method throws an exception if source contains no elements. Чтобы вернуть значение по умолчанию вместо этого в том случае, если исходная последовательность пуста, используйте FirstOrDefault метод.To instead return a default value when the source sequence is empty, use the FirstOrDefault method.

First<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) First<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) First<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) First<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>)

Возвращает первый элемент последовательности, удовлетворяющий указанному условию.Returns the first element in a sequence that satisfies a specified condition.

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

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

TSource

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

Параметры

source
IEnumerable<TSource>

IEnumerable<T> Чтобы возвратить элемент.An IEnumerable<T> to return an element from.

predicate
Func<TSource,Boolean>

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

Возвраты

TSource TSource TSource TSource

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

Исключения

Параметр source или predicate имеет значение null.source or predicate is null.

Не найдены элементы, отвечающие условию параметра predicate.No element satisfies the condition in predicate.

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

Примеры

В следующем примере кода демонстрируется использование First<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) для возвращения первого элемента массива, удовлетворяющий условию.The following code example demonstrates how to use First<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) to return the first element of an array that satisfies a condition.

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

int first = numbers.First(number => number > 80);

Console.WriteLine(first);

/*
 This code produces the following output:

 92
*/
' Create an array of integers.
Dim numbers() As Integer =
{9, 34, 65, 92, 87, 435, 3, 54, 83, 23, 87, 435, 67, 12, 19}

' Select the first element in the array whose value is greater than 80.
Dim first As Integer = numbers.First(Function(number) number > 80)

' Display the output.
MsgBox(first)

' This code produces the following output:
'
' 92

Комментарии

First<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) Метод вызывает исключение, если соответствующий элемент не найден в source.The First<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) method throws an exception if no matching element is found in source. Чтобы вернуть значение по умолчанию вместо этого в том случае, если соответствующий элемент не найден, используйте FirstOrDefault метод.To instead return a default value when no matching element is found, use the FirstOrDefault method.

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