Enumerable.ThenByDescending Méthode

Définition

Réalise un classement des éléments d'une séquence dans l'ordre décroissant.

Surcharges

ThenByDescending<TSource,TKey>(IOrderedEnumerable<TSource>, Func<TSource,TKey>)

Réalise un classement des éléments d'une séquence dans l'ordre décroissant selon une clé.

ThenByDescending<TSource,TKey>(IOrderedEnumerable<TSource>, Func<TSource,TKey>, IComparer<TKey>)

Réalise un classement des éléments d'une séquence dans l'ordre décroissant à l'aide d'un comparateur spécifié.

ThenByDescending<TSource,TKey>(IOrderedEnumerable<TSource>, Func<TSource,TKey>)

Réalise un classement des éléments d'une séquence dans l'ordre décroissant selon une clé.

public:
generic <typename TSource, typename TKey>
[System::Runtime::CompilerServices::Extension]
 static System::Linq::IOrderedEnumerable<TSource> ^ ThenByDescending(System::Linq::IOrderedEnumerable<TSource> ^ source, Func<TSource, TKey> ^ keySelector);
public static System.Linq.IOrderedEnumerable<TSource> ThenByDescending<TSource,TKey> (this System.Linq.IOrderedEnumerable<TSource> source, Func<TSource,TKey> keySelector);
static member ThenByDescending : System.Linq.IOrderedEnumerable<'Source> * Func<'Source, 'Key> -> System.Linq.IOrderedEnumerable<'Source>
<Extension()>
Public Function ThenByDescending(Of TSource, TKey) (source As IOrderedEnumerable(Of TSource), keySelector As Func(Of TSource, TKey)) As IOrderedEnumerable(Of TSource)

Paramètres de type

TSource

Le type des éléments de source.

TKey

Type de clé retournée par keySelector.

Paramètres

source
IOrderedEnumerable<TSource>

IOrderedEnumerable<TElement> qui contient les éléments à trier.

keySelector
Func<TSource,TKey>

Fonction permettant d'extraire une clé de chaque élément.

Retours

IOrderedEnumerable<TElement> dont les éléments sont triés dans l'ordre décroissant selon une clé.

Exceptions

source ou keySelector est null.

Remarques

Cette méthode est implémentée à l’aide de l’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 un nombre quelconque de ThenBy méthodes ou ThenByDescending .

Notes

Étant donné qu’hérite IOrderedEnumerable<TElement> de IEnumerable<T>, vous pouvez appeler OrderBy ou OrderByDescending sur les résultats d’un appel à OrderBy, OrderByDescendingThenBy ou ThenByDescending. Cela introduit un nouveau classement principal qui ignore le classement établi précédemment.

Cette méthode de tri 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 C#, une orderby [first criterion], [second criterion] descending clause se traduit par un appel de ThenByDescending.

Dans la syntaxe d’expression de requête Visual Basic, une Order By [first criterion], [second criterion] Descending clause se traduit par un appel de ThenByDescending.

Voir aussi

S’applique à

ThenByDescending<TSource,TKey>(IOrderedEnumerable<TSource>, Func<TSource,TKey>, IComparer<TKey>)

Réalise un classement des éléments d'une séquence dans l'ordre décroissant à l'aide d'un comparateur spécifié.

public:
generic <typename TSource, typename TKey>
[System::Runtime::CompilerServices::Extension]
 static System::Linq::IOrderedEnumerable<TSource> ^ ThenByDescending(System::Linq::IOrderedEnumerable<TSource> ^ source, Func<TSource, TKey> ^ keySelector, System::Collections::Generic::IComparer<TKey> ^ comparer);
public static System.Linq.IOrderedEnumerable<TSource> ThenByDescending<TSource,TKey> (this System.Linq.IOrderedEnumerable<TSource> source, Func<TSource,TKey> keySelector, System.Collections.Generic.IComparer<TKey> comparer);
public static System.Linq.IOrderedEnumerable<TSource> ThenByDescending<TSource,TKey> (this System.Linq.IOrderedEnumerable<TSource> source, Func<TSource,TKey> keySelector, System.Collections.Generic.IComparer<TKey>? comparer);
static member ThenByDescending : System.Linq.IOrderedEnumerable<'Source> * Func<'Source, 'Key> * System.Collections.Generic.IComparer<'Key> -> System.Linq.IOrderedEnumerable<'Source>
<Extension()>
Public Function ThenByDescending(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

TSource

Le type des éléments de source.

TKey

Type de clé retournée par keySelector.

Paramètres

source
IOrderedEnumerable<TSource>

IOrderedEnumerable<TElement> qui contient les éléments à trier.

keySelector
Func<TSource,TKey>

Fonction permettant d'extraire une clé de chaque élément.

comparer
IComparer<TKey>

IComparer<T> pour comparer les clés.

Retours

IOrderedEnumerable<TElement> dont les éléments sont triés dans l'ordre décroissant selon une clé.

Exceptions

source ou keySelector est null.

Exemples

L’exemple de code suivant montre comment utiliser ThenByDescending<TSource,TKey>(IOrderedEnumerable<TSource>, Func<TSource,TKey>, IComparer<TKey>) pour effectuer un classement secondaire des éléments d’une séquence dans l’ordre décroissant à l’aide d’un comparateur personnalisé.

public class CaseInsensitiveComparer : IComparer<string>
{
    public int Compare(string x, string y)
    {
        return string.Compare(x, y, true);
    }
}

public static void ThenByDescendingEx1()
{
    string[] fruits = { "apPLe", "baNanA", "apple", "APple", "orange", "BAnana", "ORANGE", "apPLE" };

    // Sort the strings first ascending by their length and
    // then descending using a custom case insensitive comparer.
    IEnumerable<string> query =
        fruits
        .OrderBy(fruit => fruit.Length)
        .ThenByDescending(fruit => fruit, new CaseInsensitiveComparer());

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

/*
    This code produces the following output:

    apPLe
    apple
    APple
    apPLE
    orange
    ORANGE
    baNanA
    BAnana
*/
' This class provides a custom implementation of the Compare() method.
Class CaseInsensitiveComparer
    Implements IComparer(Of String)

    Function Compare(ByVal x As String, ByVal y As String) As Integer _
    Implements IComparer(Of String).Compare

        ' Compare values and ignore case.
        Return String.Compare(x, y, True)
    End Function
End Class

Sub ThenByDescendingEx1()
    Dim fruits() As String =
    {"apPLe", "baNanA", "apple", "APple", "orange", "BAnana", "ORANGE", "apPLE"}

    ' Sort the strings first by their length and then
    ' by using a custom "case insensitive" comparer.
    Dim query As IEnumerable(Of String) =
    fruits _
    .OrderBy(Function(fruit) fruit.Length) _
    .ThenByDescending(Function(fruit) fruit, New CaseInsensitiveComparer())

    ' 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())
End Sub

' This code produces the following output:

' apPLe
' apple
' APple
' apPLE
' orange
' ORANGE
' baNanA
' BAnana

Remarques

Cette méthode est implémentée à l’aide de l’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 un nombre quelconque de ThenBy méthodes ou ThenByDescending .

Notes

Étant donné qu’hérite IOrderedEnumerable<TElement> de IEnumerable<T>, vous pouvez appeler OrderBy ou OrderByDescending sur les résultats d’un appel à OrderBy, OrderByDescendingThenBy ou ThenByDescending. Cela introduit un nouveau classement principal qui ignore le classement établi précédemment.

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é.

S’applique à