Enumerable.OrderBy 메서드

정의

네임스페이스:: System.Linq

어셈블리:: System.Core.dll, System.Linq.dll

어셈블리:: System.Core.dll

어셈블리:: System.Linq.dll

어셈블리:: netstandard.dll

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

시퀀스의 요소를 오름차순으로 정렬합니다.

오버로드

Name	Description
OrderBy<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>)	키에 따라 시퀀스의 요소를 오름차순으로 정렬합니다.
OrderBy<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>, IComparer<TKey>)	지정된 비교자를 사용하여 시퀀스의 요소를 오름차순으로 정렬합니다.

OrderBy<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>)

키에 따라 시퀀스의 요소를 오름차순으로 정렬합니다.

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)

형식 매개 변수

TSource

의 요소 형식입니다 source.

TKey

keySelector반환된 키의 형식입니다.

매개 변수

source: IEnumerable<TSource>

정렬할 값의 시퀀스입니다.

keySelector: Func<TSource,TKey>

요소에서 키를 추출하는 함수입니다.

반품

IOrderedEnumerable<TSource>

IOrderedEnumerable<TElement> 키에 따라 요소가 정렬되는 요소입니다.

예외

ArgumentNullException

source 또는 keySelector .입니다 null.

예제

다음 코드 예제에서는 시퀀스의 요소를 정렬하는 데 사용하는 OrderBy<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>) 방법을 보여 줍니다.

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

설명

이 메서드는 지연된 실행을 사용하여 구현됩니다. 즉시 반환 값은 작업을 수행하는 데 필요한 모든 정보를 저장하는 개체입니다. 이 메서드가 나타내는 쿼리는 해당 GetEnumerator 메서드를 직접 호출하거나 C#의 foreach 또는 Visual Basic For Each 사용하여 개체가 열거될 때까지 실행되지 않습니다.

요소 자체의 값으로 시퀀스를 정렬하려면 keySelector 대한 ID 함수(C#의 경우 x => x 또는 Visual Basic Function(x) x)를 지정합니다.

이 메서드의 반환 형식인 형식 IOrderedEnumerable<TElement>을 확장하기 위해 두 메서드가 정의됩니다. 이러한 두 메서드, 즉 ThenByThenByDescending, 시퀀스를 정렬하는 추가 정렬 조건을 지정할 수 있습니다. ThenBy을 반환IOrderedEnumerable<TElement>합니다ThenByDescending. 즉, 연속 호출 ThenBy 의 수를 의미하거나 ThenByDescending 수행할 수 있습니다.

참고

IOrderedEnumerable<TElement> 에서 상속되므로 IEnumerable<T>호출 OrderBy 하거나 OrderByDescending 호출 ThenBy OrderBy OrderByDescending ThenByDescending결과 또는 . 이렇게 하면 이전에 설정된 순서를 무시하는 새 기본 순서가 도입됩니다.

이 메서드는 기본 비교자를 사용하여 키를 비교합니다 Default.

이 메서드는 안정적인 정렬을 수행합니다. 즉, 두 요소의 키가 같으면 요소의 순서가 유지됩니다. 반면, 불안정한 정렬은 키가 같은 요소의 순서를 유지하지 않습니다.

쿼리 식 구문에서 orderby(C#) 또는 Order By(Visual Basic) 절은 OrderBy 호출로 변환됩니다.

추가 정보

적용 대상

OrderBy<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>, IComparer<TKey>)

지정된 비교자를 사용하여 시퀀스의 요소를 오름차순으로 정렬합니다.

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

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)