Enumerable.ThenByDescending Methode

Definition

Namespace:

System.Linq

Assembly:

System.Linq.dll

Führt eine nachfolgende Sortierung der Elemente in einer Sequenz in absteigender Reihenfolge durch

Überlädt

ThenByDescending<TSource,TKey>(IOrderedEnumerable<TSource>, Func<TSource,TKey>)	Führt eine nachfolgende Sortierung der Elemente in einer Sequenz in absteigender Reihenfolge nach einem Schlüssel durch
ThenByDescending<TSource,TKey>(IOrderedEnumerable<TSource>, Func<TSource,TKey>, IComparer<TKey>)	Führt mithilfe eines angegebenen Vergleichs eine nachfolgende Sortierung der Elemente in einer Sequenz in absteigender Reihenfolge durch

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

Quelle:

OrderBy.cs

Führt eine nachfolgende Sortierung der Elemente in einer Sequenz in absteigender Reihenfolge nach einem Schlüssel durch

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)

Typparameter

TSource

Der Typ der Elemente von source.

TKey

Der Typ des von keySelector zurückgegebenen Schlüssels.

Parameter

source

IOrderedEnumerable<TSource>

Ein IOrderedEnumerable<TElement> mit den zu sortierenden Elementen.

keySelector

Func<TSource,TKey>

Eine Funktion zum Extrahieren eines Schlüssels aus jedem Element.

Gibt zurück

IOrderedEnumerable<TSource>

Ein IOrderedEnumerable<TElement>, dessen Elemente in absteigender Reihenfolge nach einem Schlüssel sortiert werden

Ausnahmen

ArgumentNullException

source oder keySelector ist null.

Hinweise

Diese Methode wird mithilfe der verzögerten Ausführung implementiert. Der Sofortige Rückgabewert ist ein Objekt, das alle Informationen speichert, die zum Ausführen der Aktion erforderlich sind. Die von dieser Methode dargestellte Abfrage wird erst ausgeführt, wenn das Objekt entweder durch direktes Aufrufen der GetEnumerator -Methode oder mithilfe foreach von in C# oder For Each in Visual Basic aufgezählt wird.

Um eine Sequenz nach den Werten der Elemente selbst zu ordnen, geben Sie die Identitätsfunktion (x => x in C# oder Function(x) x in Visual Basic) für keySelectoran.

ThenBy und ThenByDescending sind definiert, um den Typ IOrderedEnumerable<TElement>zu erweitern, der auch der Rückgabetyp dieser Methoden ist. Mit diesem Entwurf können Sie mehrere Sortierkriterien angeben, indem Sie eine beliebige Anzahl von ThenBy Methoden oder ThenByDescending anwenden.

Hinweis

Da IOrderedEnumerable<TElement> sie von IEnumerable<T>erbt, können Sie oder OrderByDescending für die Ergebnisse eines Aufrufs OrderByvon , OrderByDescendingoder ThenByThenByDescendingaufrufenOrderBy. Dadurch wird eine neue primäre Reihenfolge eingeführt, die die zuvor festgelegte Reihenfolge ignoriert.

Diese Sortiermethode vergleicht Schlüssel mithilfe des Standardvergleichs Default.

Diese Methode führt eine stabile Sortierung aus. Das heißt, wenn die Schlüssel von zwei Elementen gleich sind, wird die Reihenfolge der Elemente beibehalten. Im Gegensatz dazu behält eine instabile Sortierung nicht die Reihenfolge der Elemente bei, die über denselben Schlüssel verfügen.

In der Syntax des C#-Abfrageausdrucks wird eine orderby [first criterion], [second criterion] descending -Klausel in einen Aufruf von ThenByDescendingübersetzt.

In der Visual Basic-Abfrageausdruckssyntax wird eine Order By [first criterion], [second criterion] Descending -Klausel in einen Aufruf von ThenByDescendingübersetzt.

Weitere Informationen

• orderby-Klausel (C#-Referenz)
• ORDER BY-Klausel (Visual Basic)

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

Quelle:

OrderBy.cs

Führt mithilfe eines angegebenen Vergleichs eine nachfolgende Sortierung der Elemente in einer Sequenz in absteigender Reihenfolge durch

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)

Typparameter

TSource

Der Typ der Elemente von source.

TKey

Der Typ des von keySelector zurückgegebenen Schlüssels.

Parameter

source

IOrderedEnumerable<TSource>

Ein IOrderedEnumerable<TElement> mit den zu sortierenden Elementen.

keySelector

Func<TSource,TKey>

Eine Funktion zum Extrahieren eines Schlüssels aus jedem Element.

comparer

IComparer<TKey>

Ein IComparer<T> zum Vergleichen von Schlüsseln.

Gibt zurück

IOrderedEnumerable<TSource>

Ein IOrderedEnumerable<TElement>, dessen Elemente in absteigender Reihenfolge nach einem Schlüssel sortiert werden

Ausnahmen

ArgumentNullException

source oder keySelector ist null.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ThenByDescending<TSource,TKey>(IOrderedEnumerable<TSource>, Func<TSource,TKey>, IComparer<TKey>) mithilfe eines benutzerdefinierten Vergleichs eine sekundäre Reihenfolge der Elemente in einer Sequenz in absteigender Reihenfolge ausgeführt wird.

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

Hinweise

Diese Methode wird mithilfe der verzögerten Ausführung implementiert. Der Sofortige Rückgabewert ist ein Objekt, das alle Informationen speichert, die zum Ausführen der Aktion erforderlich sind. Die von dieser Methode dargestellte Abfrage wird erst ausgeführt, wenn das Objekt entweder durch direktes Aufrufen der GetEnumerator -Methode oder mithilfe foreach von in C# oder For Each in Visual Basic aufgezählt wird.

Um eine Sequenz nach den Werten der Elemente selbst zu ordnen, geben Sie die Identitätsfunktion (x => x in C# oder Function(x) x in Visual Basic) für keySelectoran.

ThenBy und ThenByDescending sind definiert, um den Typ IOrderedEnumerable<TElement>zu erweitern, der auch der Rückgabetyp dieser Methoden ist. Mit diesem Entwurf können Sie mehrere Sortierkriterien angeben, indem Sie eine beliebige Anzahl von ThenBy Methoden oder ThenByDescending anwenden.

Hinweis

Da IOrderedEnumerable<TElement> sie von IEnumerable<T>erbt, können Sie oder OrderByDescending für die Ergebnisse eines Aufrufs OrderByvon , OrderByDescendingoder ThenByThenByDescendingaufrufenOrderBy. Dadurch wird eine neue primäre Reihenfolge eingeführt, die die zuvor festgelegte Reihenfolge ignoriert.

Wenn comparer ist null, wird der Standardvergleich Default zum Vergleichen von Schlüsseln verwendet.

Diese Methode führt eine stabile Sortierung aus. Das heißt, wenn die Schlüssel von zwei Elementen gleich sind, wird die Reihenfolge der Elemente beibehalten. Im Gegensatz dazu behält eine instabile Sortierung nicht die Reihenfolge der Elemente bei, die über denselben Schlüssel verfügen.