Enumerable.OrderBy Methode

Definitie

Naamruimte:: System.Linq

Assembly's:: System.Core.dll, System.Linq.dll

Assembly:: System.Core.dll

Assembly:: System.Linq.dll

Assembly:: netstandard.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Hiermee sorteert u de elementen van een reeks in oplopende volgorde.

Overloads

Name	Description
OrderBy<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>)	Sorteert de elementen van een reeks in oplopende volgorde op basis van een sleutel.
OrderBy<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>, IComparer<TKey>)	Hiermee sorteert u de elementen van een reeks in oplopende volgorde met behulp van een opgegeven vergelijkingsfunctie.

OrderBy<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>)

Sorteert de elementen van een reeks in oplopende volgorde op basis van een sleutel.

public:
generic <typename TSource, typename TKey>
[System::Runtime::CompilerServices::Extension]
 static System::Linq::IOrderedEnumerable<TSource> ^ OrderBy(System::Collections::Generic::IEnumerable<TSource> ^ source, Func<TSource, TKey> ^ keySelector);

public static System.Linq.IOrderedEnumerable<TSource> OrderBy<TSource,TKey>(this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,TKey> keySelector);

static member OrderBy : seq<'Source> * Func<'Source, 'Key> -> System.Linq.IOrderedEnumerable<'Source>

<Extension()>
Public Function OrderBy(Of TSource, TKey) (source As IEnumerable(Of TSource), keySelector As Func(Of TSource, TKey)) As IOrderedEnumerable(Of TSource)

Type parameters

TSource

Het type van de elementen van source.

TKey

Het type sleutel dat wordt geretourneerd door keySelector.

Parameters

source: IEnumerable<TSource>

Een reeks waarden op volgorde.

keySelector: Func<TSource,TKey>

Een functie om een sleutel uit een element te extraheren.

Retouren

IOrderedEnumerable<TSource>

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

Uitzonderingen

ArgumentNullException

source of keySelector is null.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe OrderBy<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>) u de elementen van een reeks kunt sorteren.

class Pet
{
    public string Name { get; set; }
    public int Age { get; set; }
}

public static void OrderByEx1()
{
    Pet[] pets = { new Pet { Name="Barley", Age=8 },
                   new Pet { Name="Boots", Age=4 },
                   new Pet { Name="Whiskers", Age=1 } };

    IEnumerable<Pet> query = pets.OrderBy(pet => pet.Age);

    foreach (Pet pet in query)
    {
        Console.WriteLine("{0} - {1}", pet.Name, pet.Age);
    }
}

/*
 This code produces the following output:

 Whiskers - 1
 Boots - 4
 Barley - 8
*/

Structure Pet
    Public Name As String
    Public Age As Integer
End Structure

Sub OrderByEx1()
    ' Create an array of Pet objects.
    Dim pets() As Pet = {New Pet With {.Name = "Barley", .Age = 8},
                     New Pet With {.Name = "Boots", .Age = 4},
                     New Pet With {.Name = "Whiskers", .Age = 1}}

    ' Order the Pet objects by their Age property.
    Dim query As IEnumerable(Of Pet) =
    pets.OrderBy(Function(pet) pet.Age)

    Dim output As New System.Text.StringBuilder
    For Each pt As Pet In query
        output.AppendLine(pt.Name & " - " & pt.Age)
    Next

    ' Display the output.
    Console.WriteLine(output.ToString())
End Sub

' This code produces the following output:
'
' Whiskers - 1
' Boots - 4
' Barley - 8

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.

Er worden twee methoden gedefinieerd om het type IOrderedEnumerable<TElement>uit te breiden. Dit is het retourtype van deze methode. Met deze twee methoden kunt u extra ThenByThenByDescendingsorteercriteria opgeven om een reeks te sorteren. ThenBy en ThenByDescending ook een IOrderedEnumerable<TElement>, wat betekent dat een willekeurig aantal opeenvolgende aanroepen naar ThenBy of ThenByDescending kan worden gedaan.

Note

Omdat IOrderedEnumerable<TElement> u OrderBy IEnumerable<T>OrderByDescending de resultaten van een aanroep van OrderByDescending OrderBy ThenBy , of .ThenByDescending Hiermee wordt een nieuwe primaire volgorde geïntroduceerd die de eerder vastgestelde volgorde negeert.

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 (C#) of Order By (Visual Basic) omgezet in een aanroep van OrderBy.

Zie ook

Van toepassing op

OrderBy<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>, IComparer<TKey>)

Hiermee sorteert u de elementen van een reeks in oplopende volgorde met behulp van een opgegeven vergelijkingsfunctie.

public:
generic <typename TSource, typename TKey>
[System::Runtime::CompilerServices::Extension]
 static System::Linq::IOrderedEnumerable<TSource> ^ OrderBy(System::Collections::Generic::IEnumerable<TSource> ^ source, Func<TSource, TKey> ^ keySelector, System::Collections::Generic::IComparer<TKey> ^ comparer);

public static System.Linq.IOrderedEnumerable<TSource> OrderBy<TSource,TKey>(this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,TKey> keySelector, System.Collections.Generic.IComparer<TKey> comparer);

static member OrderBy : seq<'Source> * Func<'Source, 'Key> * System.Collections.Generic.IComparer<'Key> -> System.Linq.IOrderedEnumerable<'Source>

<Extension()>
Public Function OrderBy(Of TSource, TKey) (source As IEnumerable(Of TSource), keySelector As Func(Of TSource, TKey), comparer As IComparer(Of TKey)) As IOrderedEnumerable(Of TSource)