Enumerable.Take<TSource>(IEnumerable<TSource>, Int32) Método

Definición

Espacio de nombres:

System.Linq

Ensamblado:

System.Core.dll

Devuelve un número especificado de elementos contiguos desde el inicio de una secuencia.

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)

Parámetros de tipo

TSource

Tipo de los elementos de source.

Parámetros

source

IEnumerable<TSource>

Secuencia de la que se van a devolver elementos.

count

Int32

Número de elementos que se van a devolver.

Devoluciones

IEnumerable<TSource>

que IEnumerable<T> contiene el número especificado de elementos desde el principio de la secuencia de entrada.

Excepciones

ArgumentNullException

source es null.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar Take para devolver elementos desde el principio de una secuencia (después de ordenarlo).

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

Comentarios

Este método se implementa mediante la ejecución diferida. El valor devuelto inmediato es un objeto que almacena toda la información necesaria para realizar la acción. La consulta representada por este método no se ejecuta hasta que el objeto se enumera llamando directamente a su método /> en C# o en Visual Basic.

Take source enumera y produce elementos hasta que count se han producido elementos o source no contiene más elementos. Si count supera el número de elementos de source, se devuelven todos los elementos de source .

Si count es menor o igual que cero, source no se enumera y se devuelve un vacío IEnumerable<T> .

Los Take métodos y Skip son complementos funcionales. Dada una secuencia coll de colección y un entero n, concatenando los resultados de coll.Take(n) y coll.Skip(n) produce la misma secuencia que coll.

En Visual Basic sintaxis de expresión de consulta, una cláusula Take se traduce en una invocación de Take.

Consulte también

• cláusula Take (Visual Basic)