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.

例外

ソース シーケンスが空です。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 または predicatenull です。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.

適用対象