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

注釈

このメソッドによって提供される機能は、 または ThenByDescendingによってThenBy提供される機能と似ています。これは、 falsetrue と のどちらdescendingであるかに応じて異なります。 どちらも、 型の既に並べ替えられたシーケンスの下位順序を実行します IOrderedEnumerable<TElement>。