Enumerable.First Метод

Определение

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

System.Linq

Сборка:

System.Linq.dll

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

Перегрузки

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

First<TSource>(IEnumerable<TSource>)

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

First.cs

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

C#

public static TSource First<TSource> (this System.Collections.Generic.IEnumerable<TSource> source);

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

TSource

Тип элементов source.

Параметры

source

IEnumerable<TSource>

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

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

TSource

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

Исключения

ArgumentNullException

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

InvalidOperationException

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

Примеры

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

C#

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
*/

Комментарии

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

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

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

First.cs

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

C#

public static TSource First<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,bool> predicate);

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

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

C#

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
*/

Комментарии

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