Enumerable.First Метод

Определение

Пространство имен:

System.Linq

Сборка:

System.Linq.dll

Возвращает первый элемент последовательности.

Перегрузки

First<TSource>(IEnumerable<TSource>)	Возвращает первый элемент последовательности.
First<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>)	Возвращает первый элемент последовательности, удовлетворяющий указанному условию.

First<TSource>(IEnumerable<TSource>)

Исходный код:

First.cs

Возвращает первый элемент последовательности.

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.

Параметры

source

IEnumerable<TSource>

Объект IEnumerable<T>, первый элемент которого требуется возвратить.

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

TSource

Первый элемент указанной последовательности.

Исключения

ArgumentNullException

source имеет значение null.

InvalidOperationException

Исходная последовательность пуста.

Примеры

В следующем примере кода показано, как использовать First<TSource>(IEnumerable<TSource>) для возврата первого элемента массива.

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.
Console.WriteLine(first)

' This code produces the following output:
'
' 9

Комментарии

Метод First<TSource>(IEnumerable<TSource>) создает исключение, если source не содержит элементов. Чтобы вместо этого возвращать значение по умолчанию, если исходная последовательность пуста FirstOrDefault , используйте метод .

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

Исходный код:

First.cs

Возвращает первый элемент последовательности, удовлетворяющий указанному условию.

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.

Параметры

source

IEnumerable<TSource>

Объект IEnumerable<T>, из которого требуется возвратить элемент.

predicate

Func<TSource,Boolean>

Функция для проверки каждого элемента на соответствие условию.

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

TSource

Первый элемент последовательности, который прошел проверку, определенную указанной функцией предиката.

Исключения

ArgumentNullException

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

InvalidOperationException

Ни один элемент не удовлетворяет условию предиката predicate.

-или-

Исходная последовательность пуста.

Примеры

В следующем примере кода показано, как использовать First<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) для возврата первого элемента массива, удовлетворяющего условию.

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.
Console.WriteLine(first)

' This code produces the following output:
'
' 92

Комментарии

Метод First<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) создает исключение, если в sourceне найден соответствующий элемент. Чтобы вместо этого возвращать значение по умолчанию, если соответствующий элемент не найден, используйте FirstOrDefault метод .