Enumerable.ThenBy Méthode

Source:

OrderBy.cs

Source:

OrderBy.cs

Source:

OrderBy.cs

public:
generic <typename TSource, typename TKey>
[System::Runtime::CompilerServices::Extension]
 static System::Linq::IOrderedEnumerable<TSource> ^ ThenBy(System::Linq::IOrderedEnumerable<TSource> ^ source, Func<TSource, TKey> ^ keySelector);

public static System.Linq.IOrderedEnumerable<TSource> ThenBy<TSource,TKey> (this System.Linq.IOrderedEnumerable<TSource> source, Func<TSource,TKey> keySelector);

static member ThenBy : System.Linq.IOrderedEnumerable<'Source> * Func<'Source, 'Key> -> System.Linq.IOrderedEnumerable<'Source>

<Extension()>
Public Function ThenBy(Of TSource, TKey) (source As IOrderedEnumerable(Of TSource), keySelector As Func(Of TSource, TKey)) As IOrderedEnumerable(Of TSource)

Paramètres de type

Paramètres

Retours

IOrderedEnumerable<TElement> dont les éléments sont triés selon une clé.

Exceptions

Exemples

L’exemple de code suivant montre comment utiliser ThenBy<TSource,TKey>(IOrderedEnumerable<TSource>, Func<TSource,TKey>) pour effectuer un classement secondaire des éléments dans une séquence.

string[] fruits = { "grape", "passionfruit", "banana", "mango",
                      "orange", "raspberry", "apple", "blueberry" };

// Sort the strings first by their length and then
//alphabetically by passing the identity selector function.
IEnumerable<string> query =
    fruits.OrderBy(fruit => fruit.Length).ThenBy(fruit => fruit);

foreach (string fruit in query)
{
    Console.WriteLine(fruit);
}

/*
    This code produces the following output:

    apple
    grape
    mango
    banana
    orange
    blueberry
    raspberry
    passionfruit
*/

' Create an array of strings.
Dim fruits() As String =
{"grape", "passionfruit", "banana", "mango",
 "orange", "raspberry", "apple", "blueberry"}

' Sort the strings first by their length and then
' alphabetically by passing the identity function.
Dim query As IEnumerable(Of String) =
fruits _
.OrderBy(Function(fruit) fruit.Length) _
.ThenBy(Function(fruit) fruit)

' Display the results.
Dim output As New System.Text.StringBuilder
For Each fruit As String In query
    output.AppendLine(fruit)
Next
Console.WriteLine(output.ToString())

' This code produces the following output:
'
' apple
' grape
' mango
' banana
' orange
' blueberry
' raspberry
' passionfruit

Remarques

Cette méthode est implémentée à l’aide d’une exécution différée. La valeur de retour immédiat est un objet qui stocke toutes les informations nécessaires à l’exécution de l’action. La requête représentée par cette méthode n’est pas exécutée tant que l’objet n’est pas énuméré soit en appelant directement sa GetEnumerator méthode, soit en utilisant foreach en C# ou For Each en Visual Basic.

Pour classer une séquence en fonction des valeurs des éléments eux-mêmes, spécifiez la fonction d’identité (x => x en C# ou Function(x) x en Visual Basic) pour keySelector.

ThenBy et ThenByDescending sont définis pour étendre le type IOrderedEnumerable<TElement>, qui est également le type de retour de ces méthodes. Cette conception vous permet de spécifier plusieurs critères de tri en appliquant n’importe quel nombre de ThenBy méthodes ou ThenByDescending .

Cette méthode compare les clés à l’aide du comparateur Defaultpar défaut .

Cette méthode effectue un tri stable ; autrement dit, si les clés de deux éléments sont égales, l’ordre des éléments est conservé. En revanche, un tri instable ne conserve pas l’ordre des éléments qui ont la même clé.

Dans la syntaxe d’expression de requête, une orderby [first criterion], [second criterion] clause (C#) ou Order By [first criterion], [second criterion] (Visual Basic) se traduit par un appel de ThenBy.

Voir aussi

• orderby, clause (Référence C#)
• Order By, clause (Visual Basic)

Source:

OrderBy.cs

Source:

OrderBy.cs

Source:

OrderBy.cs

public:
generic <typename TSource, typename TKey>
[System::Runtime::CompilerServices::Extension]
 static System::Linq::IOrderedEnumerable<TSource> ^ ThenBy(System::Linq::IOrderedEnumerable<TSource> ^ source, Func<TSource, TKey> ^ keySelector, System::Collections::Generic::IComparer<TKey> ^ comparer);

public static System.Linq.IOrderedEnumerable<TSource> ThenBy<TSource,TKey> (this System.Linq.IOrderedEnumerable<TSource> source, Func<TSource,TKey> keySelector, System.Collections.Generic.IComparer<TKey> comparer);

public static System.Linq.IOrderedEnumerable<TSource> ThenBy<TSource,TKey> (this System.Linq.IOrderedEnumerable<TSource> source, Func<TSource,TKey> keySelector, System.Collections.Generic.IComparer<TKey>? comparer);

static member ThenBy : System.Linq.IOrderedEnumerable<'Source> * Func<'Source, 'Key> * System.Collections.Generic.IComparer<'Key> -> System.Linq.IOrderedEnumerable<'Source>

<Extension()>
Public Function ThenBy(Of TSource, TKey) (source As IOrderedEnumerable(Of TSource), keySelector As Func(Of TSource, TKey), comparer As IComparer(Of TKey)) As IOrderedEnumerable(Of TSource)

Paramètres de type

Paramètres

Retours

IOrderedEnumerable<TElement> dont les éléments sont triés selon une clé.

Exceptions

Remarques

Cette méthode est implémentée à l’aide d’une exécution différée. La valeur de retour immédiat est un objet qui stocke toutes les informations nécessaires à l’exécution de l’action. La requête représentée par cette méthode n’est pas exécutée tant que l’objet n’est pas énuméré soit en appelant directement sa GetEnumerator méthode, soit en utilisant foreach en C# ou For Each en Visual Basic.

Pour classer une séquence en fonction des valeurs des éléments eux-mêmes, spécifiez la fonction d’identité (x => x en C# ou Function(x) x en Visual Basic) pour keySelector.

ThenBy et ThenByDescending sont définis pour étendre le type IOrderedEnumerable<TElement>, qui est également le type de retour de ces méthodes. Cette conception vous permet de spécifier plusieurs critères de tri en appliquant n’importe quel nombre de ThenBy méthodes ou ThenByDescending .

Si comparer a la valeur null, le comparateur Default par défaut est utilisé pour comparer les clés.

Cette méthode effectue un tri stable ; autrement dit, si les clés de deux éléments sont égales, l’ordre des éléments est conservé. En revanche, un tri instable ne conserve pas l’ordre des éléments qui ont la même clé.