Queryable.ThenBy Método

  • Referencia

Definición

Espacio de nombres:
System.Linq
Ensamblado:
System.Linq.Queryable.dll
Ensamblado:
System.Core.dll
Ensamblado:
netstandard.dll

Realiza una clasificación posterior de los elementos de una secuencia en orden ascendente.

Sobrecargas

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

Realiza una clasificación posterior de los elementos de una secuencia en orden ascendentes con arreglo a una clave.
ThenBy<TSource,TKey>(IOrderedQueryable<TSource>, Expression<Func<TSource,TKey>>, IComparer<TKey>)

Realiza una clasificación posterior de los elementos de una secuencia en orden ascendente utilizando un comparador especificado.

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

Realiza una clasificación posterior de los elementos de una secuencia en orden ascendentes con arreglo a una clave.

public:
generic <typename TSource, typename TKey>
[System::Runtime::CompilerServices::Extension]
 static System::Linq::IOrderedQueryable<TSource> ^ ThenBy(System::Linq::IOrderedQueryable<TSource> ^ source, System::Linq::Expressions::Expression<Func<TSource, TKey> ^> ^ keySelector);
public static System.Linq.IOrderedQueryable<TSource> ThenBy<TSource,TKey> (this System.Linq.IOrderedQueryable<TSource> source, System.Linq.Expressions.Expression<Func<TSource,TKey>> keySelector);
static member ThenBy : System.Linq.IOrderedQueryable<'Source> * System.Linq.Expressions.Expression<Func<'Source, 'Key>> -> System.Linq.IOrderedQueryable<'Source>
<Extension()>
Public Function ThenBy(Of TSource, TKey) (source As IOrderedQueryable(Of TSource), keySelector As Expression(Of Func(Of TSource, TKey))) As IOrderedQueryable(Of TSource)

Parámetros de tipo

TSource

Tipo de los elementos de source.

TKey

Tipo de la clave devuelta por la función representada en keySelector.

Parámetros

source
IOrderedQueryable<TSource>

IOrderedQueryable<T> que contiene los elementos que se van a ordenar.

keySelector
Expression<Func<TSource,TKey>>

Función para extraer una clave a partir de cada elemento.

Devoluciones

IOrderedQueryable<TSource>

Una interfaz IOrderedQueryable<T> cuyos elementos se ordenan con arreglo a una clave.

Excepciones

ArgumentNullException

source o keySelector es null.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar ThenBy<TSource,TKey>(IOrderedQueryable<TSource>, Expression<Func<TSource,TKey>>) para realizar una ordenación secundaria de los elementos de una secuencia.

string[] fruits = { "grape", "passionfruit", "banana", "apple",
                      "orange", "raspberry", "mango", "blueberry" };

// Sort the strings first by their length and then
// alphabetically by passing the identity selector function.
IEnumerable<string> query =
    fruits.AsQueryable()
    .OrderBy(fruit => fruit.Length).ThenBy(fruit => fruit);

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

/*
    This code produces the following output:

    apple
    grape
    mango
    banana
    orange
    blueberry
    raspberry
    passionfruit
*/

Dim fruits() As String = _
    {"grape", "passionfruit", "banana", "mango", _
     "orange", "raspberry", "apple", "blueberry"}

' Sort the strings first by their length and then 
' alphabetically by passing the identity selector function.
Dim query = fruits.AsQueryable() _
    .OrderBy(Function(fruit) fruit.Length).ThenBy(Function(fruit) fruit)

' Display the results.
Dim output As New System.Text.StringBuilder
For Each fruit As String In query
    output.AppendLine(fruit)
Next
MsgBox(output.ToString())

'This code produces the following output:

'apple
'grape
'mango
'banana
'orange
'blueberry
'raspberry
'passionfruit

Comentarios

Este método tiene al menos un parámetro de tipo Expression<TDelegate> cuyo argumento de tipo es uno de los Func<T,TResult> tipos. Para estos parámetros, puede pasar una expresión lambda y se compilará en .Expression<TDelegate>

El ThenBy<TSource,TKey>(IOrderedQueryable<TSource>, Expression<Func<TSource,TKey>>) método genera un MethodCallExpression objeto que representa llamarse ThenBy<TSource,TKey>(IOrderedQueryable<TSource>, Expression<Func<TSource,TKey>>) a sí mismo como un método genérico construido. A continuación, pasa al MethodCallExpression CreateQuery<TElement>(Expression) método del IQueryProvider representado por la Provider propiedad del source parámetro . El resultado de la llamada CreateQuery<TElement>(Expression) se convierte al tipo IOrderedQueryable<T> y se devuelve.

El comportamiento de consulta que se produce como resultado de ejecutar un árbol de expresión que representa la llamada ThenBy<TSource,TKey>(IOrderedQueryable<TSource>, Expression<Func<TSource,TKey>>) depende de la implementación del tipo del source parámetro. El comportamiento esperado es que realiza un tipo secundario de los elementos de source según la clave obtenida invocando keySelector en cada elemento de source. Se conservan todos los criterios de ordenación establecidos anteriormente.

Se aplica a

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

Realiza una clasificación posterior de los elementos de una secuencia en orden ascendente utilizando un comparador especificado.

public:
generic <typename TSource, typename TKey>
[System::Runtime::CompilerServices::Extension]
 static System::Linq::IOrderedQueryable<TSource> ^ ThenBy(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> ThenBy<TSource,TKey> (this 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> ThenBy<TSource,TKey> (this System.Linq.IOrderedQueryable<TSource> source, System.Linq.Expressions.Expression<Func<TSource,TKey>> keySelector, System.Collections.Generic.IComparer<TKey>? comparer);
static member ThenBy : System.Linq.IOrderedQueryable<'Source> * System.Linq.Expressions.Expression<Func<'Source, 'Key>> * System.Collections.Generic.IComparer<'Key> -> System.Linq.IOrderedQueryable<'Source>
<Extension()>
Public Function ThenBy(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)

Parámetros de tipo

TSource

Tipo de los elementos de source.

TKey

Tipo de la clave devuelta por la función representada en keySelector.

Parámetros

source
IOrderedQueryable<TSource>

IOrderedQueryable<T> que contiene los elementos que se van a ordenar.

keySelector
Expression<Func<TSource,TKey>>

Función para extraer una clave a partir de cada elemento.

comparer
IComparer<TKey>

IComparer<T> para comparar claves.

Devoluciones

IOrderedQueryable<TSource>

Una interfaz IOrderedQueryable<T> cuyos elementos se ordenan con arreglo a una clave.

Excepciones

ArgumentNullException

source o keySelector o comparer es null.

Comentarios

Este método tiene al menos un parámetro de tipo Expression<TDelegate> cuyo argumento de tipo es uno de los Func<T,TResult> tipos. Para estos parámetros, puede pasar una expresión lambda y se compilará en .Expression<TDelegate>

El ThenBy<TSource,TKey>(IOrderedQueryable<TSource>, Expression<Func<TSource,TKey>>, IComparer<TKey>) método genera un MethodCallExpression objeto que representa llamarse ThenBy<TSource,TKey>(IOrderedQueryable<TSource>, Expression<Func<TSource,TKey>>, IComparer<TKey>) a sí mismo como un método genérico construido. A continuación, pasa al MethodCallExpression CreateQuery<TElement>(Expression) método del IQueryProvider representado por la Provider propiedad del source parámetro . El resultado de la llamada CreateQuery<TElement>(Expression) se convierte al tipo IOrderedQueryable<T> y se devuelve.

El comportamiento de consulta que se produce como resultado de ejecutar un árbol de expresión que representa la llamada ThenBy<TSource,TKey>(IOrderedQueryable<TSource>, Expression<Func<TSource,TKey>>, IComparer<TKey>) depende de la implementación del tipo del source parámetro. El comportamiento esperado es que realiza un tipo secundario de los elementos de source según la clave obtenida invocando keySelector en cada elemento de source. Se conservan todos los criterios de ordenación establecidos anteriormente. El comparer parámetro se usa para comparar valores de clave.

Se aplica a