ObjectQuery<T>.OrderBy(String, ObjectParameter[]) Метод

Определение

Пространство имен:

System.Data.Objects

Сборка:

System.Data.Entity.dll

Сортирует результаты запроса по заданному критерию.

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)

Параметры

keys

String

Ключевые столбцы, по которым упорядочиваются результаты.

parameters

ObjectParameter[]

Параметры (ноль или более), используемые в этом методе.

Возвращаемое значение

ObjectQuery<T>

Новый экземпляр запроса ObjectQuery<T>, эквивалентный первоначальному экземпляру с примененным к нему предложением ORDER BY.

Исключения

ArgumentNullException

Значение параметра keys или параметра parameters — null.

ArgumentException

key является пустой строкой.

Примеры

В этом примере создается новый ObjectQuery<T> объект , содержащий результаты существующего порядка запросов по 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);
    }
}

Комментарии

Порядок результатов во вложенном запросе гарантировать нельзя.

OrderBy всегда должен быть окончательным методом построителя запросов в последовательности.

См. также раздел

• Запросы к данным как к объектам (платформа Entity Framework)