IOrderedEnumerable<TElement>.CreateOrderedEnumerable<TKey> Метод

Определение

Пространство имен:

System.Linq

Сборка:

System.Linq.dll

Выполняет дополнительное упорядочение элементов объекта IOrderedEnumerable<TElement> по ключу.

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)

Параметры типа

TKey

Тип ключа, созданного функцией keySelector.

Параметры

keySelector

Func<TElement,TKey>

Функция Func<T,TResult>, используемая для извлечения ключа для каждого элемента.

comparer

IComparer<TKey>

Компаратор IComparer<T>, используемый для сравнения ключей при формировании возвращаемой последовательности.

descending

Boolean

true, если элементы требуется сортировать в порядке убывания; false, чтобы сортировать элементы в порядке возрастания.

Возвращаемое значение

IOrderedEnumerable<TElement>

Объект IOrderedEnumerable<TElement>, элементы которого отсортированы по ключу.

Примеры

В следующем примере кода показано, как использовать CreateOrderedEnumerable для выполнения дополнительного упорядочения в .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

Комментарии

Функциональные возможности, предоставляемые этим методом, похожи на ThenBy функции, предоставляемые или ThenByDescending, в зависимости от того, имеет ли descending значение или truefalse. Они оба выполняют подчиненное упорядочение уже отсортированных последовательностей типа IOrderedEnumerable<TElement>.