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)

Type parameters

Parameters

Retouren

Een IOrderedEnumerable<TElement> waarvan de elementen 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.

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.

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)

Type parameters

Parameters

Retouren

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

Uitzonderingen

Voorbeelden

In het volgende codevoorbeeld ziet u hoe ThenBy<TSource,TKey>(IOrderedEnumerable<TSource>, Func<TSource,TKey>) u een secundaire volgorde van de elementen in een reeks kunt uitvoeren.

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

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 methode 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 query-expressie wordt een component orderby [first criterion], [second criterion] (C#) of Order By [first criterion], [second criterion] (Visual Basic) omgezet in een aanroep van ThenBy.

Zie ook

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