Queryable.ThenByDescending 메서드

정의

네임스페이스:

System.Linq

어셈블리:

System.Linq.Queryable.dll

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

오버로드

ThenByDescending<TSource,TKey>(IOrderedQueryable<TSource>, Expression<Func<TSource,TKey>>)	시퀀스의 요소를 키에 따라 내림차순으로 다시 정렬합니다.
ThenByDescending<TSource,TKey>(IOrderedQueryable<TSource>, Expression<Func<TSource,TKey>>, IComparer<TKey>)	시퀀스의 요소를 지정된 비교자를 사용하여 내림차순으로 다시 정렬합니다.

ThenByDescending<TSource,TKey>(IOrderedQueryable<TSource>, Expression<Func<TSource,TKey>>)

Source:

Queryable.cs

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

public:
generic <typename TSource, typename TKey>
[System::Runtime::CompilerServices::Extension]
 static System::Linq::IOrderedQueryable<TSource> ^ ThenByDescending(System::Linq::IOrderedQueryable<TSource> ^ source, System::Linq::Expressions::Expression<Func<TSource, TKey> ^> ^ keySelector);

public static System.Linq.IOrderedQueryable<TSource> ThenByDescending<TSource,TKey> (this System.Linq.IOrderedQueryable<TSource> source, System.Linq.Expressions.Expression<Func<TSource,TKey>> keySelector);

static member ThenByDescending : System.Linq.IOrderedQueryable<'Source> * System.Linq.Expressions.Expression<Func<'Source, 'Key>> -> System.Linq.IOrderedQueryable<'Source>

<Extension()>
Public Function ThenByDescending(Of TSource, TKey) (source As IOrderedQueryable(Of TSource), keySelector As Expression(Of Func(Of TSource, TKey))) As IOrderedQueryable(Of TSource)

형식 매개 변수

TSource

source 요소의 형식입니다.

TKey

keySelector에 지정된 함수가 반환하는 키 형식입니다.

매개 변수

source

IOrderedQueryable<TSource>

정렬할 요소가 들어 있는 IOrderedQueryable<T>입니다.

keySelector

Expression<Func<TSource,TKey>>

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

반환

IOrderedQueryable<TSource>

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

예외

ArgumentNullException

source 또는 keySelector가 null인 경우

설명

이 메서드에는 형식 인수가 형식 중 하나인 형식 Expression<TDelegate> 의 매개 변수가 Func<T,TResult> 하나 이상 있습니다. 이러한 매개 변수의 경우 람다 식을 전달할 수 있으며 에 컴파일됩니다 Expression<TDelegate>.

메서드는 ThenByDescending<TSource,TKey>(IOrderedQueryable<TSource>, Expression<Func<TSource,TKey>>)MethodCallExpression 생성된 제네릭 메서드로 자신을 호출 ThenByDescending<TSource,TKey>(IOrderedQueryable<TSource>, Expression<Func<TSource,TKey>>) 하는 를 나타내는 을 생성합니다. 그런 다음 을 MethodCallExpression 매개 변수의 CreateQuery<TElement>(Expression) 속성으로 나타내는 의 IQueryProvider 메서드에 Providersource 전달합니다. 호출 CreateQuery<TElement>(Expression) 결과는 형식 IOrderedQueryable<T> 으로 캐스팅되고 반환됩니다.

호출 ThenByDescending<TSource,TKey>(IOrderedQueryable<TSource>, Expression<Func<TSource,TKey>>) 을 나타내는 식 트리를 실행한 결과로 발생하는 쿼리 동작은 매개 변수 형식의 source 구현에 따라 달라집니다. 예상되는 동작은 의 각 source요소에서 를 호출 keySelector 하여 얻은 키를 기반으로 의 요소 source 의 보조 종류를 내림차순으로 수행하는 것입니다. 이전에 설정한 모든 정렬 순서가 유지됩니다.

ThenByDescending<TSource,TKey>(IOrderedQueryable<TSource>, Expression<Func<TSource,TKey>>, IComparer<TKey>)

Source:

Queryable.cs

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

public:
generic <typename TSource, typename TKey>
[System::Runtime::CompilerServices::Extension]
 static System::Linq::IOrderedQueryable<TSource> ^ ThenByDescending(System::Linq::IOrderedQueryable<TSource> ^ source, System::Linq::Expressions::Expression<Func<TSource, TKey> ^> ^ keySelector, System::Collections::Generic::IComparer<TKey> ^ comparer);

public static System.Linq.IOrderedQueryable<TSource> ThenByDescending<TSource,TKey> (this System.Linq.IOrderedQueryable<TSource> source, System.Linq.Expressions.Expression<Func<TSource,TKey>> keySelector, System.Collections.Generic.IComparer<TKey>? comparer);

static member ThenByDescending : System.Linq.IOrderedQueryable<'Source> * System.Linq.Expressions.Expression<Func<'Source, 'Key>> * System.Collections.Generic.IComparer<'Key> -> System.Linq.IOrderedQueryable<'Source>

<Extension()>
Public Function ThenByDescending(Of TSource, TKey) (source As IOrderedQueryable(Of TSource), keySelector As Expression(Of Func(Of TSource, TKey)), comparer As IComparer(Of TKey)) As IOrderedQueryable(Of TSource)

형식 매개 변수

TSource

source 요소의 형식입니다.

TKey

keySelector 함수가 반환하는 키 형식입니다.

매개 변수

source

IOrderedQueryable<TSource>

정렬할 요소가 들어 있는 IOrderedQueryable<T>입니다.

keySelector

Expression<Func<TSource,TKey>>

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

comparer

IComparer<TKey>

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

반환

IOrderedQueryable<TSource>

요소가 키에 따라 내림차순으로 정렬된 컬렉션입니다.

예외

ArgumentNullException

source, keySelector 또는 comparer가 null인 경우

예제

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

public class CaseInsensitiveComparer : IComparer<string>
{
    public int Compare(string x, string y)
    {
        return string.Compare(x, y, true);
    }
}

public static void ThenByDescendingEx1()
{
    string[] fruits =
    { "apPLe", "baNanA", "apple", "APple", "orange", "BAnana", "ORANGE", "apPLE" };

    // Sort the strings first ascending by their length and
    // then descending using a custom case insensitive comparer.
    IEnumerable<string> query =
        fruits.AsQueryable()
        .OrderBy(fruit => fruit.Length)
        .ThenByDescending(fruit => fruit, new CaseInsensitiveComparer());

    foreach (string fruit in query)
        Console.WriteLine(fruit);
}

/*
    This code produces the following output:

    apPLe
    apple
    APple
    apPLE
    orange
    ORANGE
    baNanA
    BAnana
*/

Class CaseInsensitiveComparer
    Implements IComparer(Of String)

    Function Compare(ByVal x As String, ByVal y As String) As Integer _
        Implements IComparer(Of String).Compare

        ' Compare values and ignore case.
        Return String.Compare(x, y, True)
    End Function
End Class

Sub ThenByDescendingEx1()
    Dim fruits() As String = _
        {"apPLe", "baNanA", "apple", "APple", "orange", "BAnana", "ORANGE", "apPLE"}

    ' Sort the strings first ascending by their length and 
    ' then descending by using a custom case insensitive comparer.
    Dim query = fruits.AsQueryable() _
        .OrderBy(Function(fruit) fruit.Length) _
        .ThenByDescending(Function(fruit) fruit, New CaseInsensitiveComparer())

    Dim output As New System.Text.StringBuilder
    For Each fruit As String In query
        output.AppendLine(fruit)
    Next

    ' Display the results.
    MsgBox(output.ToString())
End Sub

' This code produces the following output:

' apPLe
' apple
' APple
' apPLE
' orange
' ORANGE
' baNanA
' BAnana

설명

이 메서드에는 형식 인수가 형식 중 하나인 형식 Expression<TDelegate> 의 매개 변수가 Func<T,TResult> 하나 이상 있습니다. 이러한 매개 변수의 경우 람다 식을 전달할 수 있으며 에 컴파일됩니다 Expression<TDelegate>.

메서드는 ThenBy<TSource,TKey>(IOrderedQueryable<TSource>, Expression<Func<TSource,TKey>>, IComparer<TKey>)MethodCallExpression 생성된 제네릭 메서드로 자신을 호출 ThenBy<TSource,TKey>(IOrderedQueryable<TSource>, Expression<Func<TSource,TKey>>, IComparer<TKey>) 하는 를 나타내는 을 생성합니다. 그런 다음 을 MethodCallExpression 매개 변수의 CreateQuery<TElement>(Expression) 속성으로 나타내는 의 IQueryProvider 메서드에 Providersource 전달합니다. 호출 CreateQuery<TElement>(Expression) 결과는 형식 IOrderedQueryable<T> 으로 캐스팅되고 반환됩니다.

호출 ThenBy<TSource,TKey>(IOrderedQueryable<TSource>, Expression<Func<TSource,TKey>>, IComparer<TKey>) 을 나타내는 식 트리를 실행한 결과로 발생하는 쿼리 동작은 매개 변수 형식의 source 구현에 따라 달라집니다. 예상되는 동작은 의 각 source요소에서 를 호출 keySelector 하여 얻은 키를 기반으로 의 요소 source 의 보조 종류를 내림차순으로 수행하는 것입니다. 이전에 설정한 모든 정렬 순서가 유지됩니다. comparer 매개 변수는 키 값을 비교하는 데 사용됩니다.