Queryable.OrderBy Método

Definición

Ordena de manera ascendente los elementos de una secuencia.Sorts the elements of a sequence in ascending order.

Sobrecargas

OrderBy<TSource,TKey>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, IComparer<TKey>)

Ordena de manera ascendente los elementos de una secuencia utilizando un comparador especificado.Sorts the elements of a sequence in ascending order by using a specified comparer.

OrderBy<TSource,TKey>(IQueryable<TSource>, Expression<Func<TSource,TKey>>)

Ordena de manera ascendente los elementos de una secuencia en función de una clave.Sorts the elements of a sequence in ascending order according to a key.

OrderBy<TSource,TKey>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, IComparer<TKey>)

Ordena de manera ascendente los elementos de una secuencia utilizando un comparador especificado.Sorts the elements of a sequence in ascending order by using a specified comparer.

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

TKey

Tipo de la clave devuelto por la función representada por keySelector.The type of the key returned by the function that is represented by keySelector.

Parámetros

source
IQueryable<TSource>

Secuencia de valores que se va a ordenar.A sequence of values to order.

keySelector
Expression<Func<TSource,TKey>>

Función para extraer una clave a partir de un elemento.A function to extract a key from an element.

comparer
IComparer<TKey>

IComparer<T> para comparar claves.An IComparer<T> to compare keys.

Devoluciones

IOrderedQueryable<TSource>

Una interfaz IOrderedQueryable<T> cuyos elementos se ordenan con arreglo a una clave.An IOrderedQueryable<T> whose elements are sorted according to a key.

Excepciones

source o keySelector o comparer es null.source or keySelector or comparer is 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.This method has at least one parameter of type Expression<TDelegate> whose type argument is one of the Func<T,TResult> types. Para estos parámetros, puede pasar una expresión lambda y se compilará en un Expression<TDelegate> .For these parameters, you can pass in a lambda expression and it will be compiled to an Expression<TDelegate>.

El OrderBy<TSource,TKey>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, IComparer<TKey>) método genera un MethodCallExpression que representa la llamada a OrderBy<TSource,TKey>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, IComparer<TKey>) sí mismo como un método genérico construido.The OrderBy<TSource,TKey>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, IComparer<TKey>) method generates a MethodCallExpression that represents calling OrderBy<TSource,TKey>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, IComparer<TKey>) itself as a constructed generic method. A continuación, pasa el MethodCallExpression al CreateQuery<TElement>(Expression) método de IQueryProvider representado por la Provider propiedad del source parámetro.It then passes the MethodCallExpression to the CreateQuery<TElement>(Expression) method of the IQueryProvider represented by the Provider property of the source parameter. El resultado de la llamada CreateQuery<TElement>(Expression) a se convierte al tipo IOrderedQueryable<T> y se devuelve.The result of calling CreateQuery<TElement>(Expression) is cast to type IOrderedQueryable<T> and returned.

El comportamiento de la consulta que se produce como resultado de ejecutar un árbol de expresión que representa OrderBy<TSource,TKey>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, IComparer<TKey>) la llamada depende de la implementación del tipo del source parámetro.The query behavior that occurs as a result of executing an expression tree that represents calling OrderBy<TSource,TKey>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, IComparer<TKey>) depends on the implementation of the type of the source parameter. El comportamiento esperado es que ordene los elementos de source basándose en la clave obtenida al invocar keySelector en cada elemento de source .The expected behavior is that it sorts the elements of source based on the key obtained by invoking keySelector on each element of source. El comparer parámetro se usa para comparar claves.The comparer parameter is used to compare keys.

Se aplica a

OrderBy<TSource,TKey>(IQueryable<TSource>, Expression<Func<TSource,TKey>>)

Ordena de manera ascendente los elementos de una secuencia en función de una clave.Sorts the elements of a sequence in ascending order according to a key.

public:
generic <typename TSource, typename TKey>
[System::Runtime::CompilerServices::Extension]
 static System::Linq::IOrderedQueryable<TSource> ^ OrderBy(System::Linq::IQueryable<TSource> ^ source, System::Linq::Expressions::Expression<Func<TSource, TKey> ^> ^ keySelector);
public static System.Linq.IOrderedQueryable<TSource> OrderBy<TSource,TKey> (this System.Linq.IQueryable<TSource> source, System.Linq.Expressions.Expression<Func<TSource,TKey>> keySelector);
static member OrderBy : System.Linq.IQueryable<'Source> * System.Linq.Expressions.Expression<Func<'Source, 'Key>> -> System.Linq.IOrderedQueryable<'Source>
<Extension()>
Public Function OrderBy(Of TSource, TKey) (source As IQueryable(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.The type of the elements of source.

TKey

Tipo de la clave devuelto por la función representada por keySelector.The type of the key returned by the function that is represented by keySelector.

Parámetros

source
IQueryable<TSource>

Secuencia de valores que se va a ordenar.A sequence of values to order.

keySelector
Expression<Func<TSource,TKey>>

Función para extraer una clave a partir de un elemento.A function to extract a key from an element.

Devoluciones

IOrderedQueryable<TSource>

Una interfaz IOrderedQueryable<T> cuyos elementos se ordenan con arreglo a una clave.An IOrderedQueryable<T> whose elements are sorted according to a key.

Excepciones

source o keySelector es null.source or keySelector is null.

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar OrderBy<TSource,TKey>(IQueryable<TSource>, Expression<Func<TSource,TKey>>) para ordenar los elementos de una secuencia.The following code example demonstrates how to use OrderBy<TSource,TKey>(IQueryable<TSource>, Expression<Func<TSource,TKey>>) to sort the elements of a sequence.

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

    // Sort the Pet objects in the array by Pet.Age.
    IEnumerable<Pet> query =
        pets.AsQueryable().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

Shared Sub OrderByEx1()
    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}}

    ' Sort the Pet objects in the array by Pet.Age.
    Dim query As IEnumerable(Of Pet) = _
                pets.AsQueryable().OrderBy(Function(pet) pet.Age)

    Dim output As New System.Text.StringBuilder
    For Each pet As Pet In query
        output.AppendLine(String.Format("{0} - {1}", pet.Name, pet.Age))
    Next

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

' This code produces the following output:

' Whiskers - 1
' Boots - 4
' Barley - 8

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.This method has at least one parameter of type Expression<TDelegate> whose type argument is one of the Func<T,TResult> types. Para estos parámetros, puede pasar una expresión lambda y se compilará en un Expression<TDelegate> .For these parameters, you can pass in a lambda expression and it will be compiled to an Expression<TDelegate>.

El OrderBy<TSource,TKey>(IQueryable<TSource>, Expression<Func<TSource,TKey>>) método genera un MethodCallExpression que representa la llamada a OrderBy<TSource,TKey>(IQueryable<TSource>, Expression<Func<TSource,TKey>>) sí mismo como un método genérico construido.The OrderBy<TSource,TKey>(IQueryable<TSource>, Expression<Func<TSource,TKey>>) method generates a MethodCallExpression that represents calling OrderBy<TSource,TKey>(IQueryable<TSource>, Expression<Func<TSource,TKey>>) itself as a constructed generic method. A continuación, pasa el MethodCallExpression al CreateQuery<TElement>(Expression) método de IQueryProvider representado por la Provider propiedad del source parámetro.It then passes the MethodCallExpression to the CreateQuery<TElement>(Expression) method of the IQueryProvider represented by the Provider property of the source parameter. El resultado de la llamada CreateQuery<TElement>(Expression) a se convierte al tipo IOrderedQueryable<T> y se devuelve.The result of calling CreateQuery<TElement>(Expression) is cast to type IOrderedQueryable<T> and returned.

El comportamiento de la consulta que se produce como resultado de ejecutar un árbol de expresión que representa OrderBy<TSource,TKey>(IQueryable<TSource>, Expression<Func<TSource,TKey>>) la llamada depende de la implementación del tipo del source parámetro.The query behavior that occurs as a result of executing an expression tree that represents calling OrderBy<TSource,TKey>(IQueryable<TSource>, Expression<Func<TSource,TKey>>) depends on the implementation of the type of the source parameter. El comportamiento esperado es que ordene los elementos de source basándose en la clave obtenida al invocar keySelector en cada elemento de source .The expected behavior is that it sorts the elements of source based on the key obtained by invoking keySelector on each element of source.

Se aplica a