Enumerable.ThenBy Methode

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

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)

Typparameter

Parameter

Gibt zurück

Ein Element IOrderedEnumerable<TElement> , dessen Elemente nach einem Schlüssel sortiert sind.

Ausnahmen

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 durch diese Methode dargestellte Abfrage wird erst ausgeführt, wenn das Objekt aufgezählt wird, indem die GetEnumerator-Methode direkt oder mithilfe von foreach in C# oder For Each in Visual Basic aufgerufen 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 keySelector an.

ThenBy und ThenByDescending werden 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 Methoden anwenden.

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

Diese Methode führt eine stabile Sortierung durch; d. h., wenn die Schlüssel zweier Elemente gleich sind, wird die Reihenfolge der Elemente beibehalten. Im Gegensatz dazu behält eine instabile Sortierung nicht die Reihenfolge der Elemente bei, die denselben Schlüssel aufweisen.

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)

Typparameter

Parameter

Gibt zurück

Ein Element IOrderedEnumerable<TElement> , dessen Elemente nach einem Schlüssel sortiert sind.

Ausnahmen

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie ThenBy<TSource,TKey>(IOrderedEnumerable<TSource>, Func<TSource,TKey>) eine sekundäre Reihenfolge der Elemente in einer Sequenz ausgeführt wird.

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

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 durch diese Methode dargestellte Abfrage wird erst ausgeführt, wenn das Objekt aufgezählt wird, indem die GetEnumerator-Methode direkt oder mithilfe von foreach in C# oder For Each in Visual Basic aufgerufen 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 keySelector an.

ThenBy und ThenByDescending werden 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 Methoden anwenden.

Diese Methode vergleicht Schlüssel mithilfe des Standardvergleichs Default.

Diese Methode führt eine stabile Sortierung durch; d. h., wenn die Schlüssel zweier Elemente gleich sind, wird die Reihenfolge der Elemente beibehalten. Im Gegensatz dazu behält eine instabile Sortierung nicht die Reihenfolge der Elemente bei, die denselben Schlüssel aufweisen.

In der Abfrageausdruckssyntax wird eine orderby [first criterion], [second criterion] (C#) oder Order By [first criterion], [second criterion] (Visual Basic) in einen Aufruf von ThenBy übersetzt.

Weitere Informationen

• orderby-Klausel (C#-Referenz)
• Order By Clause (Visual Basic)