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

Definição

Espaço de Nomes:
System.Linq
Assemblagens:
System.Core.dll, System.Linq.dll
Assemblagem:
System.Core.dll
Assemblagem:
System.Linq.dll
Assemblagem:
netstandard.dll

Realiza uma ordenação subsequente nos elementos de um IOrderedEnumerable<TElement> segundo uma tonalidade.

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<TElement> CreateOrderedEnumerable<TKey>(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 TElement, TKey), comparer As IComparer(Of TKey), descending As Boolean) As IOrderedEnumerable(Of TElement)
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 Genérico

TKey

O tipo da tonalidade produzida por keySelector.

Parâmetros

keySelector
Func<TElement,TKey>

Eles Func<T,TResult> são usados para extrair a chave de cada elemento.

comparer
IComparer<TKey>

É IComparer<T> usado para comparar as chaves para a colocação na sequência devolvida.

descending
Boolean

true ordenar os elementos por ordem decrescente; false para ordenar os elementos por ordem crescente.

Devoluções

IOrderedEnumerable<TElement>

E IOrderedEnumerable<TElement> cujos elementos são ordenados de acordo com uma chave.

Exemplos

O exemplo de código seguinte demonstra como usar CreateOrderedEnumerable para realizar uma ordenação secundária num 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

Observações

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

Aplica-se a