IOrderedEnumerable<TElement>.CreateOrderedEnumerable<TKey> Método

Definição

Namespace:

System.Linq

Assembly:

System.Linq.dll

Executa uma ordenação subsequente nos elementos de uma IOrderedEnumerable<TElement> de acordo com uma chave.

public:
generic <typename TKey>
 System::Linq::IOrderedEnumerable<TElement> ^ CreateOrderedEnumerable(Func<TElement, TKey> ^ keySelector, System::Collections::Generic::IComparer<TKey> ^ comparer, bool descending);

public System.Linq.IOrderedEnumerable<out TElement> CreateOrderedEnumerable<TKey> (Func<out TElement,TKey> keySelector, System.Collections.Generic.IComparer<TKey>? comparer, bool descending);

abstract member CreateOrderedEnumerable : Func<'Element, 'Key> * System.Collections.Generic.IComparer<'Key> * bool -> System.Linq.IOrderedEnumerable<'Element>

Public Function CreateOrderedEnumerable(Of TKey) (keySelector As Func(Of Out TElement, TKey), comparer As IComparer(Of TKey), descending As Boolean) As IOrderedEnumerable(Of Out TElement)

Parâmetros de tipo

TKey

O tipo da chave produzida por keySelector.

Parâmetros

keySelector

Func<TElement,TKey>

O Func<T,TResult> usado para extrair a chave de cada elemento.

comparer

IComparer<TKey>

O IComparer<T> usado para comparar chaves para posicionamento na sequência retornada.

descending

Boolean

true para classificar os elementos em ordem decrescente; false para classificar os elementos em ordem crescente.

Retornos

IOrderedEnumerable<TElement>

Um IOrderedEnumerable<TElement> cujos elementos são classificados de acordo com uma chave.

Exemplos

O exemplo de código a seguir demonstra como usar CreateOrderedEnumerable para executar uma ordenação secundária em um IOrderedEnumerable<TElement>.

// Create an array of strings to sort.
string[] fruits = { "apricot", "orange", "banana", "mango", "apple", "grape", "strawberry" };
// First sort the strings by their length.
IOrderedEnumerable<string> sortedFruits2 =
    fruits.OrderBy(fruit => fruit.Length);
// Secondarily sort the strings alphabetically, using the default comparer.
IOrderedEnumerable<string> sortedFruits3 =
    sortedFruits2.CreateOrderedEnumerable<string>(
        fruit => fruit,
        Comparer<string>.Default, false);

// Output the resulting sequence of strings.
foreach (string fruit in sortedFruits3)
    Console.WriteLine(fruit);

// This code produces the following output:
//
// apple
// grape
// mango
// banana
// orange
// apricot
// strawberry

' Create an array of strings to sort.
Dim fruits() As String = {"apricot", "orange", "banana", "mango", "apple", "grape", "strawberry"}
' First sort the strings by their length.
Dim sortedFruits2 As IOrderedEnumerable(Of String) = _
    fruits.OrderBy(Function(ByVal fruit) fruit.Length)
' Secondarily sort the strings alphabetically, using the default comparer.
Dim sortedFruits3 As IOrderedEnumerable(Of String) = _
    sortedFruits2.CreateOrderedEnumerable(Of String)( _
        Function(ByVal fruit) fruit, _
        System.Collections.Generic.Comparer(Of String).Default, _
        False)

Dim output As New System.Text.StringBuilder
' Output the resulting sequence of strings.
For Each fruit As String In sortedFruits3
    output.AppendLine(fruit)
Next

' Display the results.
MsgBox(output.ToString())

' This code produces the following output:
'
' apple
' grape
' mango
' banana
' orange
' apricot
' strawberry

Comentários

A funcionalidade fornecida por esse método é semelhante à fornecida por ThenBy ou ThenByDescending, dependendo se descending é true ou false. Ambos executam uma ordenação subordinada de uma sequência já classificada do tipo IOrderedEnumerable<TElement>.