Enumerable.ThenBy Methode

Definition

Namespace:

System.Linq

Assembly:

System.Linq.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>)

Quelle:

OrderBy.cs

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>) 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 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 Methode 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 Abfrageausdruckssyntax wird eine orderby [first criterion], [second criterion] (C#)- oder Order By [first criterion], [second criterion] (Visual Basic)-Klausel in einen Aufruf von ThenByübersetzt.

Weitere Informationen

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

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

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