Enumerable.ThenByDescending Methode

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)

Type parameters

Parameters

Retouren

Een IOrderedEnumerable<TElement> waarvan de elementen in aflopende volgorde worden gesorteerd op basis van een sleutel.

Uitzonderingen

Opmerkingen

Deze methode wordt geïmplementeerd met behulp van de uitgestelde uitvoering. De onmiddellijke retourwaarde is een object waarin alle informatie wordt opgeslagen die nodig is om de actie uit te voeren. De query die door deze methode wordt vertegenwoordigd, wordt pas uitgevoerd nadat het object is geïnventariseerd door de methode GetEnumerator rechtstreeks aan te roepen of door foreach te gebruiken in C# of For Each in Visual Basic.

Als u een reeks wilt orden op basis van de waarden van de elementen zelf, geeft u de identiteitsfunctie (x => x in C# of Function(x) x in Visual Basic) op voor keySelector.

ThenBy en ThenByDescending worden gedefinieerd om het type IOrderedEnumerable<TElement>uit te breiden, wat ook het retourtype van deze methoden is. Met dit ontwerp kunt u meerdere sorteercriteria opgeven door een willekeurig aantal methoden ThenByDescending toe ThenBy te passen.

Met deze sorteermethode worden sleutels vergeleken met behulp van de standaard comparer Default.

Met deze methode wordt een stabiele sortering uitgevoerd; als de sleutels van twee elementen gelijk zijn, blijft de volgorde van de elementen behouden. Een instabiele sortering behoudt daarentegen niet de volgorde van elementen met dezelfde sleutel.

In de syntaxis van de C#-queryexpressie wordt een orderby [first criterion], [second criterion] descending component omgezet in een aanroep van ThenByDescending.

In Visual Basic syntaxis van de query-expressie wordt een Order By [first criterion], [second criterion] Descending-component omgezet in een aanroep van ThenByDescending.

Zie ook

• orderby-component (C#-verwijzing)
• Order by Clause (Visual Basic)

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);

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)

Type parameters

Parameters

Retouren

Een IOrderedEnumerable<TElement> waarvan de elementen in aflopende volgorde worden gesorteerd op basis van een sleutel.

Uitzonderingen

Voorbeelden

In het volgende codevoorbeeld ziet u hoe ThenByDescending<TSource,TKey>(IOrderedEnumerable<TSource>, Func<TSource,TKey>, IComparer<TKey>) u een secundaire volgorde van de elementen in een aflopende volgorde kunt uitvoeren met behulp van een aangepaste vergelijkingsfunctie.

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

Opmerkingen

Deze methode wordt geïmplementeerd met behulp van de uitgestelde uitvoering. De onmiddellijke retourwaarde is een object waarin alle informatie wordt opgeslagen die nodig is om de actie uit te voeren. De query die door deze methode wordt vertegenwoordigd, wordt pas uitgevoerd nadat het object is geïnventariseerd door de methode GetEnumerator rechtstreeks aan te roepen of door foreach te gebruiken in C# of For Each in Visual Basic.

Als u een reeks wilt orden op basis van de waarden van de elementen zelf, geeft u de identiteitsfunctie (x => x in C# of Function(x) x in Visual Basic) op voor keySelector.

ThenBy en ThenByDescending worden gedefinieerd om het type IOrderedEnumerable<TElement>uit te breiden, wat ook het retourtype van deze methoden is. Met dit ontwerp kunt u meerdere sorteercriteria opgeven door een willekeurig aantal methoden ThenByDescending toe ThenBy te passen.

Als comparer dat het is null, wordt de standaard comparer Default gebruikt om sleutels te vergelijken.

Met deze methode wordt een stabiele sortering uitgevoerd; als de sleutels van twee elementen gelijk zijn, blijft de volgorde van de elementen behouden. Een instabiele sortering behoudt daarentegen niet de volgorde van elementen met dezelfde sleutel.