Enumerable.OrderByDescending 메서드

정의

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

오버로드

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

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

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

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

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

Source:
OrderBy.cs
Source:
OrderBy.cs
Source:
OrderBy.cs

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

C#
public static System.Linq.IOrderedEnumerable<TSource> OrderByDescending<TSource,TKey> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,TKey> keySelector);

형식 매개 변수

TSource

source 요소의 형식입니다.

TKey

keySelector에서 반환하는 키의 형식입니다.

매개 변수

source
IEnumerable<TSource>

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

keySelector
Func<TSource,TKey>

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

반환

요소가 키에 따라 내림차순으로 정렬된 IOrderedEnumerable<TElement>입니다.

예외

source 또는 keySelectornull인 경우

설명

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

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

이 메서드의 예제는 를 참조하세요 OrderByDescending<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>, IComparer<TKey>).

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

참고

는 에서 IEnumerable<T>상속되므로 IOrderedEnumerable<TElement> , ThenByOrderByDescending또는 에 대한 호출 결과에서 또는 ThenByDescendingOrderByDescending 를 호출 OrderByOrderBy수 있습니다. 이렇게 하면 이전에 설정된 순서를 무시하는 새 기본 순서가 도입됩니다.

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

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

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

추가 정보

적용 대상

.NET 9 및 기타 버전
제품 버전
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

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

Source:
OrderBy.cs
Source:
OrderBy.cs
Source:
OrderBy.cs

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

C#
public static System.Linq.IOrderedEnumerable<TSource> OrderByDescending<TSource,TKey> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,TKey> keySelector, System.Collections.Generic.IComparer<TKey> comparer);
C#
public static System.Linq.IOrderedEnumerable<TSource> OrderByDescending<TSource,TKey> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,TKey> keySelector, System.Collections.Generic.IComparer<TKey>? comparer);

형식 매개 변수

TSource

source 요소의 형식입니다.

TKey

keySelector에서 반환하는 키의 형식입니다.

매개 변수

source
IEnumerable<TSource>

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

keySelector
Func<TSource,TKey>

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

comparer
IComparer<TKey>

키를 비교할 IComparer<T>입니다.

반환

요소가 키에 따라 내림차순으로 정렬된 IOrderedEnumerable<TElement>입니다.

예외

source 또는 keySelectornull인 경우

예제

다음 코드 예제에서는 변환 함수와 사용자 지정 비교자를 사용하여 OrderByDescending<TSource,TKey>(IEnumerable<TSource>, Func<TSource,TKey>, IComparer<TKey>) 시퀀스의 요소를 내림차순으로 정렬하는 방법을 보여 줍니다.

C#
/// <summary>
/// This IComparer class sorts by the fractional part of the decimal number.
/// </summary>
public class SpecialComparer : IComparer<decimal>
{
    /// <summary>
    /// Compare two decimal numbers by their fractional parts.
    /// </summary>
    /// <param name="d1">The first decimal to compare.</param>
    /// <param name="d2">The second decimal to compare.</param>
    /// <returns>1 if the first decimal's fractional part
    /// is greater than the second decimal's fractional part,
    /// -1 if the first decimal's fractional
    /// part is less than the second decimal's fractional part,
    /// or the result of calling Decimal.Compare()
    /// if the fractional parts are equal.</returns>
    public int Compare(decimal d1, decimal d2)
    {
        decimal fractional1, fractional2;

        // Get the fractional part of the first number.
        try
        {
            fractional1 = decimal.Remainder(d1, decimal.Floor(d1));
        }
        catch (DivideByZeroException)
        {
            fractional1 = d1;
        }
        // Get the fractional part of the second number.
        try
        {
            fractional2 = decimal.Remainder(d2, decimal.Floor(d2));
        }
        catch (DivideByZeroException)
        {
            fractional2 = d2;
        }

        if (fractional1 == fractional2)
            return Decimal.Compare(d1, d2);
        else if (fractional1 > fractional2)
            return 1;
        else
            return -1;
    }
}

public static void OrderByDescendingEx1()
{
    List<decimal> decimals =
        new List<decimal> { 6.2m, 8.3m, 0.5m, 1.3m, 6.3m, 9.7m };

    IEnumerable<decimal> query =
        decimals.OrderByDescending(num =>
                                       num, new SpecialComparer());

    foreach (decimal num in query)
    {
        Console.WriteLine(num);
    }
}

/*
 This code produces the following output:

 9.7
 0.5
 8.3
 6.3
 1.3
 6.2
*/

설명

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

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

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

참고

는 에서 IEnumerable<T>상속되므로 IOrderedEnumerable<TElement> , ThenByOrderByDescending또는 에 대한 호출 결과에서 또는 ThenByDescendingOrderByDescending 를 호출 OrderByOrderBy수 있습니다. 이렇게 하면 이전에 설정된 순서를 무시하는 새 기본 순서가 도입됩니다.

가 이nullcomparer 기본 비교자를 Default 사용하여 키를 비교합니다.

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

추가 정보

적용 대상

.NET 9 및 기타 버전
제품 버전
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0