Queryable.Take Método

Definición

Espacio de nombres:

System.Linq

Ensamblado:

System.Linq.Queryable.dll

Sobrecargas

Take<TSource>(IQueryable<TSource>, Int32)	Devuelve un número especificado de elementos contiguos desde el principio de una secuencia.
Take<TSource>(IQueryable<TSource>, Range)	Devuelve un intervalo especificado de elementos contiguos de una secuencia.

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

Source:

Queryable.cs

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

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static System::Linq::IQueryable<TSource> ^ Take(System::Linq::IQueryable<TSource> ^ source, int count);

public static System.Linq.IQueryable<TSource> Take<TSource> (this System.Linq.IQueryable<TSource> source, int count);

static member Take : System.Linq.IQueryable<'Source> * int -> System.Linq.IQueryable<'Source>

<Extension()>
Public Function Take(Of TSource) (source As IQueryable(Of TSource), count As Integer) As IQueryable(Of TSource)

Parámetros de tipo

TSource

Tipo de los elementos de source.

Parámetros

source

IQueryable<TSource>

Secuencia cuyos elementos se van a devolver.

count

Int32

Número de elementos que se van a devolver.

Devoluciones

IQueryable<TSource>

IQueryable<T> que contiene el número especificado de elementos desde el comienzo de source.

Excepciones

ArgumentNullException

source es null.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar Take<TSource>(IQueryable<TSource>, Int32) para devolver elementos desde el inicio de una secuencia.

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

// Sort the grades in descending order and take the first three.
IEnumerable<int> topThreeGrades =
    grades.AsQueryable().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
*/

Dim grades() As Integer = {59, 82, 70, 56, 92, 98, 85}

' Sort the grades in descending order and take the first three.
Dim topThreeGrades = _
    grades.AsQueryable().OrderByDescending(Function(grade) grade).Take(3)

Dim output As New System.Text.StringBuilder
output.AppendLine("The top three grades are:")
For Each grade As Integer In topThreeGrades
    output.AppendLine(grade)
Next

' Display the output.
MsgBox(output.ToString())

' This code produces the following output:

' The top three grades are:
' 98
' 92
' 85

Comentarios

El Take<TSource>(IQueryable<TSource>, Int32) método genera un MethodCallExpression objeto que representa llamarse Take<TSource>(IQueryable<TSource>, Int32) a sí mismo como un método genérico construido. A continuación, pasa al MethodCallExpressionCreateQuery(Expression) método del IQueryProvider representado por la Provider propiedad del source parámetro .

El comportamiento de la consulta que se produce como resultado de ejecutar un árbol de expresión que representa la llamada Take<TSource>(IQueryable<TSource>, Int32) depende de la implementación del tipo del source parámetro. El comportamiento esperado es que toma los primeros count elementos del inicio de source.

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

Source:

Queryable.cs

Devuelve un intervalo especificado de elementos contiguos de una secuencia.

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static System::Linq::IQueryable<TSource> ^ Take(System::Linq::IQueryable<TSource> ^ source, Range range);

public static System.Linq.IQueryable<TSource> Take<TSource> (this System.Linq.IQueryable<TSource> source, Range range);

static member Take : System.Linq.IQueryable<'Source> * Range -> System.Linq.IQueryable<'Source>

<Extension()>
Public Function Take(Of TSource) (source As IQueryable(Of TSource), range As Range) As IQueryable(Of TSource)

Parámetros de tipo

TSource

Tipo de los elementos de source.

Parámetros

source

IQueryable<TSource>

Secuencia cuyos elementos se van a devolver.

range

Range

Intervalo de elementos que se van a devolver, que tiene índices iniciales y finales desde el principio o el final.

Devoluciones

IQueryable<TSource>

que IQueryable<T> contiene el especificado range de elementos de la source secuencia.

Excepciones

ArgumentNullException

source es null.