Queryable.Take Méthode

Définition

Espace de noms:

System.Linq

Assemblys:

netstandard.dll, System.Linq.Queryable.dll

Surcharges

Nom	Description
Take<TSource>(IQueryable<TSource>, Int32)	Retourne un nombre spécifié d’éléments contigus à partir du début d’une séquence.
Take<TSource>(IQueryable<TSource>, Range)	Retourne une plage spécifiée d’éléments contigus à partir d’une séquence.

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

Source:

Queryable.cs

Retourne un nombre spécifié d’éléments contigus à partir du début d’une séquence.

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)

Paramètres de type

TSource

Type des éléments de source.

Paramètres

source

IQueryable<TSource>

Séquence à partir de laquelle retourner des éléments.

count

Int32

Nombre d’éléments à retourner.

Retours

IQueryable<TSource>

Qui IQueryable<T> contient le nombre spécifié d’éléments à partir du début de source.

Exceptions

ArgumentNullException

source a la valeur null.

Exemples

L’exemple de code suivant montre comment retourner Take<TSource>(IQueryable<TSource>, Int32) des éléments à partir du début d’une séquence.

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

Remarques

La Take<TSource>(IQueryable<TSource>, Int32) méthode génère un qui représente l’appel MethodCallExpressionTake<TSource>(IQueryable<TSource>, Int32) lui-même en tant que méthode générique construite. Il passe ensuite la MethodCallExpressionCreateQuery(Expression) méthode de l’objet IQueryProvider représenté par la Provider propriété du source paramètre.

Le comportement de requête qui se produit suite à l’exécution d’une arborescence d’expressions qui représente l’appel Take<TSource>(IQueryable<TSource>, Int32) dépend de l’implémentation du type du source paramètre. Le comportement attendu est qu’il prend les premiers count éléments à partir du début de source.

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

Source:

Queryable.cs

Retourne une plage spécifiée d’éléments contigus à partir d’une séquence.

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)

Paramètres de type

TSource

Type des éléments de source.

Paramètres

source

IQueryable<TSource>

Séquence à partir de laquelle retourner des éléments.

range

Range

Plage d’éléments à retourner, qui a des index de début et de fin à partir du début ou de la fin.

Retours

IQueryable<TSource>

Qui IQueryable<T> contient les éléments spécifiés range de la source séquence.

Exceptions

ArgumentNullException

source a la valeur null.