Enumerable.OrderBy 메서드
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
시퀀스의 요소를 오름차순으로 정렬합니다.
OrderBy<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>) |
시퀀스의 요소를 키에 따라 오름차순으로 정렬합니다. |
OrderBy<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>, IComparer<TKey>) |
지정된 비교자를 사용하여 시퀀스의 요소를 오름차순으로 정렬합니다. |
- Source:
- OrderBy.cs
- Source:
- OrderBy.cs
- Source:
- OrderBy.cs
시퀀스의 요소를 키에 따라 오름차순으로 정렬합니다.
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<TElement>입니다.
예외
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# 또는 For Each
Visual Basic에서 를 사용하여 foreach
개체를 열거할 때까지 실행되지 않습니다.
요소 자체의 값으로 시퀀스를 정렬하려면 에 대한 ID 함수(x => x
C# 또는 Function(x) x
Visual Basic의 경우)를 keySelector
지정합니다.
이 메서드의 반환 형식인 형식 IOrderedEnumerable<TElement>을 확장하기 위해 두 개의 메서드가 정의됩니다. 이러한 두 메서드( 즉 ThenBy
, 및 ThenByDescending
)를 사용하면 시퀀스를 정렬하는 추가 정렬 조건을 지정할 수 있습니다. ThenBy
및 ThenByDescending
는 IOrderedEnumerable<TElement>또는 ThenByDescending
에 대한 연속 호출 ThenBy
수를 의미합니다.
참고
는 에서 IEnumerable<T>상속되므로 IOrderedEnumerable<TElement> , OrderByDescendingThenBy 또는 ThenByDescending에 대한 호출 결과에 대해 또는 OrderByDescending 를 호출 OrderBy 할 OrderBy수 있습니다. 이렇게 하면 이전에 설정된 순서를 무시하는 새 기본 순서가 도입됩니다.
이 메서드는 기본 비교자를 사용하여 키를 비교합니다 Default.
이 메서드는 안정적인 정렬을 수행합니다. 즉, 두 요소의 키가 같으면 요소의 순서가 유지됩니다. 반면, 불안정한 정렬은 키가 같은 요소의 순서를 유지하지 않습니다.
쿼리 식 구문 orderby
에서 (C#) 또는 Order By
(Visual Basic) 절은 의 OrderBy호출로 변환됩니다.
추가 정보
- OrderByDescending<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>)
- OrderByDescending<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>, IComparer<TKey>)
- orderby 절(C# 참조)
- Order By 절(Visual Basic)
적용 대상
- Source:
- OrderBy.cs
- Source:
- OrderBy.cs
- Source:
- OrderBy.cs
지정된 비교자를 사용하여 시퀀스의 요소를 오름차순으로 정렬합니다.
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);
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)
형식 매개 변수
- TSource
source
요소의 형식입니다.
- TKey
keySelector
에서 반환하는 키의 형식입니다.
매개 변수
- source
- IEnumerable<TSource>
정렬할 값의 시퀀스입니다.
- keySelector
- Func<TSource,TKey>
요소에서 키를 추출하는 함수입니다.
- comparer
- IComparer<TKey>
키를 비교할 IComparer<T>입니다.
반환
요소가 키에 따라 정렬된 IOrderedEnumerable<TElement>입니다.
예외
source
또는 keySelector
가 null
인 경우
설명
이 메서드는 지연 된 실행을 사용 하 여 구현 됩니다. 즉시 반환 값은 작업을 수행 하는 데 필요한 모든 정보를 저장 하는 개체입니다. 이 메서드가 나타내는 쿼리는 개체를 직접 호출 GetEnumerator
하거나 C# 또는 For Each
Visual Basic에서 를 사용하여 foreach
개체를 열거할 때까지 실행되지 않습니다.
요소 자체의 값으로 시퀀스를 정렬하려면 에 대한 ID 함수(x => x
C# 또는 Function(x) x
Visual Basic의 경우)를 keySelector
지정합니다.
이 메서드의 반환 형식인 형식 IOrderedEnumerable<TElement>을 확장하기 위해 두 개의 메서드가 정의됩니다. 이러한 두 메서드( 즉 ThenBy
, 및 ThenByDescending
)를 사용하면 시퀀스를 정렬하는 추가 정렬 조건을 지정할 수 있습니다. ThenBy
및 ThenByDescending
는 IOrderedEnumerable<TElement>또는 ThenByDescending
에 대한 연속 호출 ThenBy
수를 의미합니다.
참고
는 에서 IEnumerable<T>상속되므로 IOrderedEnumerable<TElement> , OrderByDescendingThenBy 또는 ThenByDescending에 대한 호출 결과에 대해 또는 OrderByDescending 를 호출 OrderBy 할 OrderBy수 있습니다. 이렇게 하면 이전에 설정된 순서를 무시하는 새 기본 순서가 도입됩니다.
가 이null
면 comparer
기본 비교자를 Default 사용하여 키를 비교합니다.
이 메서드는 안정적인 정렬을 수행합니다. 즉, 두 요소의 키가 같으면 요소의 순서가 유지됩니다. 반면, 불안정한 정렬은 키가 같은 요소의 순서를 유지하지 않습니다.
추가 정보
- OrderByDescending<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>)
- OrderByDescending<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>, IComparer<TKey>)
적용 대상
.NET 피드백
.NET은(는) 오픈 소스 프로젝트입니다. 다음 링크를 선택하여 피드백을 제공해 주세요.