Enumerable.OrderBy Methode

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)

Typparameter

Parameter

Gibt zurück

IOrderedEnumerable<TSource>

Ein IOrderedEnumerable<TElement>, dessen Elemente nach einem Schlüssel sortiert werdenAn IOrderedEnumerable<TElement> whose elements are sorted according to a key.

Ausnahmen

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie verwendet wird, OrderBy<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>) um die Elemente einer Sequenz zu sortieren.The following code example demonstrates how to use OrderBy<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>) to sort the elements of a sequence.

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

Hinweise

Diese Methode wird mithilfe von verzögerter Ausführung implementiert.This method is implemented by using deferred execution. Der unmittelbare Rückgabewert ist ein Objekt, das alle Informationen speichert, die zum Ausführen der Aktion erforderlich sind.The immediate return value is an object that stores all the information that is required to perform the action. Die durch diese Methode dargestellte Abfrage wird erst ausgeführt, wenn das Objekt durch Aufrufen der- GetEnumerator Methode direkt oder mithilfe von foreach in Visual c# oder in Visual Basic aufgezählt wird For Each .The query represented by this method is not executed until the object is enumerated either by calling its GetEnumerator method directly or by using foreach in Visual C# or For Each in Visual Basic.

Um eine Sequenz nach den Werten der Elemente selbst zu sortieren, geben Sie die Identitäts Funktion ( x => x in Visual c# oder Function(x) x in Visual Basic) für an keySelector .To order a sequence by the values of the elements themselves, specify the identity function (x => x in Visual C# or Function(x) x in Visual Basic) for keySelector.

Es werden zwei Methoden definiert, um den Typ zu erweitern IOrderedEnumerable<TElement> , d. h. den Rückgabetyp dieser Methode.Two methods are defined to extend the type IOrderedEnumerable<TElement>, which is the return type of this method. Diese beiden Methoden, nämlich ThenBy und ThenByDescending , ermöglichen es Ihnen, zusätzliche Sortierkriterien zum Sortieren einer Sequenz anzugeben.These two methods, namely ThenBy and ThenByDescending, enable you to specify additional sort criteria to sort a sequence. ThenBy und ThenByDescending geben auch einen zurück IOrderedEnumerable<TElement> . Dies bedeutet, dass eine beliebige Anzahl aufeinander folgender Aufrufe von ThenBy oder ThenByDescending erfolgen kann.ThenBy and ThenByDescending also return an IOrderedEnumerable<TElement>, which means any number of consecutive calls to ThenBy or ThenByDescending can be made.

Diese Methode vergleicht Schlüssel mit dem Standardcomparer Default .This method compares keys by using the default comparer Default.

Diese Methode führt eine stabile Sortierung aus. Das heißt, wenn die Schlüssel zweier Elemente gleich sind, wird die Reihenfolge der Elemente beibehalten.This method performs a stable sort; that is, if the keys of two elements are equal, the order of the elements is preserved. Im Gegensatz dazu behält eine instabile Sortierung nicht die Reihenfolge von Elementen mit demselben Schlüssel bei.In contrast, an unstable sort does not preserve the order of elements that have the same key.

In der Abfrage Ausdruckssyntax wird eine orderby (Visual c#)-oder Order By (Visual Basic)-Klausel in einen Aufruf von übersetzt OrderBy .In query expression syntax, an orderby (Visual C#) or Order By (Visual Basic) clause translates to an invocation of OrderBy.

Weitere Informationen

• OrderByDescending<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>)
• OrderByDescending<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>, IComparer<TKey>)
• orderby-Klausel (C#-Referenz)orderby clause (C# Reference)
• ORDER BY-Klausel (Visual Basic)Order By Clause (Visual Basic)

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

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)

Typparameter

Parameter

Gibt zurück

IOrderedEnumerable<TSource>

Ein IOrderedEnumerable<TElement>, dessen Elemente nach einem Schlüssel sortiert werdenAn IOrderedEnumerable<TElement> whose elements are sorted according to a key.

Ausnahmen

Hinweise

Diese Methode wird mithilfe von verzögerter Ausführung implementiert.This method is implemented by using deferred execution. Der unmittelbare Rückgabewert ist ein Objekt, das alle Informationen speichert, die zum Ausführen der Aktion erforderlich sind.The immediate return value is an object that stores all the information that is required to perform the action. Die durch diese Methode dargestellte Abfrage wird erst ausgeführt, wenn das Objekt durch Aufrufen der- GetEnumerator Methode direkt oder mithilfe von foreach in Visual c# oder in Visual Basic aufgezählt wird For Each .The query represented by this method is not executed until the object is enumerated either by calling its GetEnumerator method directly or by using foreach in Visual C# or For Each in Visual Basic.

Um eine Sequenz nach den Werten der Elemente selbst zu sortieren, geben Sie die Identitäts Funktion ( x => x in Visual c# oder Function(x) x in Visual Basic) für an keySelector .To order a sequence by the values of the elements themselves, specify the identity function (x => x in Visual C# or Function(x) x in Visual Basic) for keySelector.

Es werden zwei Methoden definiert, um den Typ zu erweitern IOrderedEnumerable<TElement> , d. h. den Rückgabetyp dieser Methode.Two methods are defined to extend the type IOrderedEnumerable<TElement>, which is the return type of this method. Diese beiden Methoden, nämlich ThenBy und ThenByDescending , ermöglichen es Ihnen, zusätzliche Sortierkriterien zum Sortieren einer Sequenz anzugeben.These two methods, namely ThenBy and ThenByDescending, enable you to specify additional sort criteria to sort a sequence. ThenBy und ThenByDescending geben auch einen zurück IOrderedEnumerable<TElement> . Dies bedeutet, dass eine beliebige Anzahl aufeinander folgender Aufrufe von ThenBy oder ThenByDescending erfolgen kann.ThenBy and ThenByDescending also return an IOrderedEnumerable<TElement>, which means any number of consecutive calls to ThenBy or ThenByDescending can be made.

Wenn comparer null den Wert hat, wird der Standardcomparer Default verwendet, um Schlüssel zu vergleichen.If comparer is null, the default comparer Default is used to compare keys.

Diese Methode führt eine stabile Sortierung aus. Das heißt, wenn die Schlüssel zweier Elemente gleich sind, wird die Reihenfolge der Elemente beibehalten.This method performs a stable sort; that is, if the keys of two elements are equal, the order of the elements is preserved. Im Gegensatz dazu behält eine instabile Sortierung nicht die Reihenfolge von Elementen mit demselben Schlüssel bei.In contrast, an unstable sort does not preserve the order of elements that have the same key.

Weitere Informationen

• OrderByDescending<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>)
• OrderByDescending<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>, IComparer<TKey>)