Enumerable.ThenBy Methode

Definition

Namespace:

System.Linq

Assembly:

System.Linq.dll

Assembly:

System.Core.dll

Assembly:

netstandard.dll

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

Überlädt

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

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

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

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

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 nach einem Schlüssel sortiert werden

Ausnahmen

ArgumentNullException

source oder keySelector ist null.

Beispiele

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

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 entweder direkt oder in foreach Visual C# oder For Each in Visual Basic aufgerufen wirdGetEnumerator.

Um eine Sequenz durch die Werte der Elemente selbst zu bestellen, geben Sie die Identitätsfunktion (x => xin Visual C# oder Function(x) x in Visual Basic) für keySelector.

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

Hinweis

Da ererbt von , können Sie die Ergebnisse eines Anrufs aufrufen ThenBy OrderByOrderByDescendingoder aufrufen , oder OrderByDescending ThenByDescending.IEnumerable<T>OrderBy IOrderedEnumerable<TElement> Dadurch wird eine neue primäre Reihenfolge eingeführt, die die zuvor erstellte Reihenfolge ignoriert.

Diese Methode vergleicht Schlüssel mithilfe des Standardvergleichs Default.

Diese Methode führt eine stabile Sortierung aus; 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] (Visual C#)- oder Order By [first criterion], [second criterion] (Visual Basic)-Klausel in einen Aufruf von ThenBy.

Siehe auch

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

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

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

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)

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

Um eine Sequenz durch die Werte der Elemente selbst zu ordnen, geben Sie die Identitätsfunktion (x => xin Visual C# oder Function(x) x in Visual Basic) für keySelector.

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

Hinweis

Da IOrderedEnumerable<TElement> sie von IEnumerable<T>geerbt wird, können OrderByDescending OrderBy Sie die Ergebnisse eines Aufrufs oder OrderByOrderByDescendingThenBy eines Aufrufs oder .ThenByDescending Dadurch wird eine neue primäre Sortierung eingeführt, die die zuvor erstellte Sortierung ignoriert.

Wenn comparer dies der Standardwert ist null, wird der Standardvergleich verwendet Default , um Schlüssel zu vergleichen.

Diese Methode führt eine stabile Sortierung aus; 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.