Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

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

 

Publicado: octubre de 2016

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

Espacio de nombres:   System.Linq
Ensamblado:  System.Core (en System.Core.dll)

public static IEnumerable<TSource> Take<TSource>(
	this IEnumerable<TSource> source,
	int count
)

Parámetros

source
Type: System.Collections.Generic.IEnumerable<TSource>

Secuencia cuyos elementos se van a devolver.

count
Type: System.Int32

Número de elementos que se van a devolver.

Valor devuelto

Type: System.Collections.Generic.IEnumerable<TSource>

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

Parámetros de tipo

TSource

Tipo de los elementos de source.

Exception Condition
ArgumentNullException

El valor de source es null.

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 se enumera el objeto llamando a su GetEnumerator método directamente o mediante foreach en Visual C# o For Each en Visual Basic.

Take<TSource> enumera source y produce elementos hasta count elementos se hayan devuelto o sourceno contiene más elementos. Si count supera el número de elementos de source, todos los elementos de sourcese devuelven.

Si count es menor o igual a cero, source no está enumerado y un vacío IEnumerable<T> se devuelve.

El Take<TSource> y Skip<TSource> métodos son complementos funcionales. Dada una secuencia de coll y un entero n, concatenar los resultados de coll.Take(n) y coll.Skip(n) genera la misma secuencia que coll.

En Visual Basic sintaxis de expresiones de consulta un Take cláusula se convierte en una invocación de Take<TSource>.

En el ejemplo de código siguiente se muestra cómo utilizar Take<TSource> para devolver los elementos desde el comienzo de una secuencia.

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

Plataforma universal de Windows
Disponible desde 8
.NET Framework
Disponible desde 3.5
Biblioteca de clases portable
Se admite en: plataformas portátiles de .NET
Silverlight
Disponible desde 2.0
Windows Phone Silverlight
Disponible desde 7.0
Windows Phone
Disponible desde 8.1
Volver al principio
Mostrar: