Enumerable.Take メソッド

定義

名前空間:

System.Linq

アセンブリ:

System.Linq.dll

オーバーロード

Take<TSource>(IEnumerable<TSource>, Int32)	シーケンスの先頭から、指定された数の連続する要素を返します。
Take<TSource>(IEnumerable<TSource>, Range)	シーケンスから指定した連続する要素の範囲を返します。

Take<TSource>(IEnumerable<TSource>, Int32)

ソース:

Take.cs

シーケンスの先頭から、指定された数の連続する要素を返します。

C#

public static System.Collections.Generic.IEnumerable<TSource> Take<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, int count);

型パラメーター

TSource

source の要素の型。

パラメーター

source

IEnumerable<TSource>

要素を返すシーケンス。

count

Int32

返す要素数。

戻り値

IEnumerable<TSource>

入力シーケンスの先頭から、指定された数の要素を含む IEnumerable<T>。

例外

ArgumentNullException

source が nullです。

例

次のコード例では、 を使用 Take してシーケンスの先頭から要素を返す方法を示します。

C#

int[] grades = { 59, 82, 70, 56, 92, 98, 85 };

IEnumerable<int> topThreeGrades =
    grades.OrderByDescending(grade => grade).Take(3);

Console.WriteLine("The top three grades are:");
foreach (int grade in topThreeGrades)
{
    Console.WriteLine(grade);
}
/*
 This code produces the following output:

 The top three grades are:
 98
 92
 85
*/

注釈

このメソッドは、遅延実行を使用して実装されます。 即時戻り値は、アクションの実行に必要なすべての情報を格納する オブジェクトです。 このメソッドで表されるクエリは、オブジェクトがメソッドを直接呼び出GetEnumeratorすか、C# For Each または Visual Basic で を使用foreachして列挙されるまで実行されません。

Take は、要素が source 生成されるまで、または要素が含まれないまで count 要素を列挙して source 生成します。 が 内sourceの要素の数を超える場合countは、 のすべての要素sourceが返されます。

が 0 以下の場合 count 、 source は列挙されず、空 IEnumerable<T> の が返されます。

Takeメソッドと Skip メソッドは、関数の補数です。 コレクション シーケンス coll と整数 nを指定すると、 の結果 coll.Take(n) を連結すると、 と coll.Skip(n) 同じシーケンス collが生成されます。

Visual Basic クエリ式の構文では、 句は Take の Take呼び出しに変換されます。

こちらもご覧ください

• Take 句 (Visual Basic)

Take<TSource>(IEnumerable<TSource>, Range)

ソース:

Take.cs

シーケンスから指定した連続する要素の範囲を返します。

C#

public static System.Collections.Generic.IEnumerable<TSource> Take<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, Range range);

型パラメーター

TSource

source の要素の型。

パラメーター

source

IEnumerable<TSource>

要素を返すシーケンス。

range

Range

シーケンスの先頭または末尾から開始インデックスと終了インデックスを持つ、返す要素の範囲。

戻り値

IEnumerable<TSource>

IEnumerable<T>シーケンスから指定した要素の範囲を格納している source 。

例外

ArgumentNullException

source は null です。

注釈

このメソッドは、遅延実行を使用して実装されます。 即時戻り値は、アクションの実行に必要なすべての情報を格納する オブジェクトです。 このメソッドで表されるクエリは、オブジェクトがメソッドを直接呼び出GetEnumeratorすか、C# For Each または Visual Basic で を使用foreachして列挙されるまで実行されません。

Take は、 source 指定した に属するインデックスを持つ要素を列挙して生成します range。