Enumerable.Take 方法

定义

重载

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

从序列的开头返回指定数量的相邻元素。

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

从序列中返回指定范围的连续元素。

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

从序列的开头返回指定数量的相邻元素。

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

类型参数

TSource

source 的元素类型。

参数

source
IEnumerable<TSource>

要从其返回元素的序列。

count
Int32

要返回的元素数量。

返回

IEnumerable<TSource>

一个 IEnumerable<T>,包含输入序列开头的指定数量的元素。

例外

sourcenull

示例

下面的代码示例演示如何使用 Take 从序列的开头返回元素。

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
*/
' Create an array of Integer values that represent grades.
Dim grades() As Integer = {59, 82, 70, 56, 92, 98, 85}

' Get the highest three grades by first sorting
' them in descending order and then taking the
' first three values.
Dim topThreeGrades As IEnumerable(Of Integer) =
grades _
.OrderByDescending(Function(grade) grade) _
.Take(3)

' Display the results.
Dim output As New System.Text.StringBuilder("The top three grades are:" & vbCrLf)
For Each grade As Integer In topThreeGrades
    output.AppendLine(grade)
Next
Console.WriteLine(output.ToString())

' This code produces the following output:
'
' The top three grades are:
' 98
' 92
' 85

注解

此方法通过使用延迟执行来实现。 即时返回值是一个对象,用于存储执行操作所需的所有信息。 在通过直接调用GetEnumerator其方法或通过在 C# For Eachforeach Visual Basic 中使用 来枚举对象之前,不会执行此方法表示的查询。

Take 枚举 source 并生成元素,直到 count 生成元素或 source 不包含更多元素。 如果 count 超过 中的 source元素数,则返回 的所有元素 source

如果 count 小于或等于零, source 则 不枚举 ,并返回空 IEnumerable<T>

TakeSkip 方法是功能补充。 给定一个集合序列 coll 和一个整数 n,将 的结果 coll.Take(n) 串联并 coll.Skip(n) 生成与 相同的序列 coll

在 Visual Basic 查询表达式语法中, Take 子句转换为 的 Take调用。

另请参阅

适用于

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

从序列中返回指定范围的连续元素。

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

类型参数

TSource

source 的元素类型。

参数

source
IEnumerable<TSource>

要从其返回元素的序列。

range
Range

要返回的元素范围,其中包含从序列的开头或结尾开始和结束索引。

返回

IEnumerable<TSource>

一个 IEnumerable<T> ,它包含序列中的指定元素 source 范围。

例外

sourcenull

注解

此方法通过使用延迟执行来实现。 即时返回值是一个对象,用于存储执行操作所需的所有信息。 在通过直接调用GetEnumerator其方法或通过在 C# For Eachforeach Visual Basic 中使用 来枚举对象之前,不会执行此方法表示的查询。

Take 枚举 source 并生成其索引属于指定 range的元素。

适用于