Queryable.OrderBy Método

Definición

Espacio de nombres:

System.Linq

Ensamblado:

System.Linq.Queryable.dll

Ordena de manera ascendente los elementos de una secuencia.

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.
OrderBy<TSource,TKey>(IQueryable<TSource>, Expression<Func<TSource,TKey>>)	Ordena de manera ascendente los elementos de una secuencia en función de una clave.

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

Source:

Queryable.cs

Ordena de manera ascendente los elementos de una secuencia utilizando un comparador especificado.

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

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.

TKey

Tipo de la clave devuelto por la función representada por keySelector.

Parámetros

source

IQueryable<TSource>

Secuencia de valores que se va a ordenar.

keySelector

Expression<Func<TSource,TKey>>

Función para extraer una clave a partir de un 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 cuyo argumento de tipo Expression<TDelegate> 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 OrderBy<TSource,TKey>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, IComparer<TKey>) método genera un MethodCallExpression objeto que representa llamarse OrderBy<TSource,TKey>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, IComparer<TKey>) a sí mismo como un método genérico construido. A continuación, pasa al MethodCallExpressionCreateQuery<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 en tipo IOrderedQueryable<T> y se devuelve.

El comportamiento de la consulta que se produce como resultado de ejecutar un árbol de expresión que representa la llamada OrderBy<TSource,TKey>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, IComparer<TKey>) depende de la implementación del tipo del source parámetro. El comportamiento esperado es que ordena los elementos de source según la clave obtenida invocando keySelector en cada elemento de source. El comparer parámetro se usa para comparar claves.

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

Source:

Queryable.cs

Ordena de manera ascendente los elementos de una secuencia en función de una clave.

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.

TKey

Tipo de la clave devuelto por la función representada por keySelector.

Parámetros

source

IQueryable<TSource>

Secuencia de valores que se va a ordenar.

keySelector

Expression<Func<TSource,TKey>>

Función para extraer una clave a partir de un 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 OrderBy<TSource,TKey>(IQueryable<TSource>, Expression<Func<TSource,TKey>>) para ordenar los elementos de una secuencia.

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 cuyo argumento de tipo Expression<TDelegate> 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 OrderBy<TSource,TKey>(IQueryable<TSource>, Expression<Func<TSource,TKey>>) método genera un MethodCallExpression objeto que representa llamarse OrderBy<TSource,TKey>(IQueryable<TSource>, Expression<Func<TSource,TKey>>) a sí mismo como un método genérico construido. A continuación, pasa al MethodCallExpressionCreateQuery<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 en tipo IOrderedQueryable<T> y se devuelve.

El comportamiento de la consulta que se produce como resultado de ejecutar un árbol de expresión que representa la llamada OrderBy<TSource,TKey>(IQueryable<TSource>, Expression<Func<TSource,TKey>>) depende de la implementación del tipo del source parámetro. El comportamiento esperado es que ordena los elementos de source según la clave obtenida invocando keySelector en cada elemento de source.