ObjectQuery<T>.OrderBy(String, ObjectParameter[]) Método

  • Referência

Definição

Namespace:
System.Data.Objects
Assembly:
System.Data.Entity.dll

Ordena os resultados da consulta pelos critérios especificados.

public:
 System::Data::Objects::ObjectQuery<T> ^ OrderBy(System::String ^ keys, ... cli::array <System::Data::Objects::ObjectParameter ^> ^ parameters);
public System.Data.Objects.ObjectQuery<T> OrderBy (string keys, params System.Data.Objects.ObjectParameter[] parameters);
member this.OrderBy : string * System.Data.Objects.ObjectParameter[] -> System.Data.Objects.ObjectQuery<'T>
Public Function OrderBy (keys As String, ParamArray parameters As ObjectParameter()) As ObjectQuery(Of T)

Parâmetros

keys
String

As colunas de chave pelas quais os resultados serão ordenados.

parameters
ObjectParameter[]

Zero ou mais parâmetros que são usados neste método.

Retornos

ObjectQuery<T>

Uma nova instância ObjectQuery<T> que é equivalente à instância original com ORDER BY aplicado.

Exceções

ArgumentNullException

O parâmetro keys ou parameters é null.

ArgumentException

O key é uma cadeia de caracteres vazia.

Exemplos

Este exemplo cria um novo ObjectQuery<T> objeto que contém os resultados da ordem de consulta existente por ProductID.

using (AdventureWorksEntities context =
    new AdventureWorksEntities())
{
    string queryString = @"SELECT VALUE product
        FROM AdventureWorksEntities.Products AS product";

    ObjectQuery<Product> productQuery1 =
        new ObjectQuery<Product>(queryString,
            context, MergeOption.NoTracking);

    ObjectQuery<Product> productQuery2 =
        productQuery1.OrderBy("it.ProductID");

    // Iterate through the collection of Product items.
    foreach (Product result in productQuery2)
    {
        Console.WriteLine("{0}", result.ProductID);
    }
}

Comentários

A ordenação de resultados em uma consulta aninhada não pode ser garantida.

OrderBy deve ser sempre o método final do construtor de consultas na sequência.

Aplica-se a

Confira também