EntityDataSource.OrderBy Propriedade

Definição

Namespace:

System.Web.UI.WebControls

Assembly:

System.Web.Entity.dll

Obtém ou define a expressão do Entity SQL que especifica como ordenar os resultados da consulta.

public:
 property System::String ^ OrderBy { System::String ^ get(); void set(System::String ^ value); };

public string OrderBy { get; set; }

member this.OrderBy : string with get, set

Public Property OrderBy As String

Valor da propriedade

String

A cláusula ORDER BY.

Exemplos

A marcação XML no exemplo a seguir, em um arquivo. aspx, recupera um valor de um controle e o passa como um parâmetro para a Where propriedade.

<asp:EntityDataSource ID="SalesOrderHeader" runat="server"
  ConnectionString="name=AdventureWorksEntities"
  DefaultContainerName="AdventureWorksEntities" EnableDelete="True"
  EnableInsert="True" EnableUpdate="True" EntitySetName="SalesOrderHeader"
  EntityTypeFilter="" OrderBy="it.TotalDue DESC" Select=""
   Where="it.OnlineOrderFlag = TRUE AND it.TotalDue > @ordercost">
  <WhereParameters>
    <asp:ControlParameter ControlID="costLimit" DbType="Int32"
      DefaultValue="2500" Name="ordercost" PropertyName="Text" />
  </WhereParameters>
</asp:EntityDataSource>

O exemplo de XML anterior é equivalente ao seguinte ObjectQuery<T> nome onlineOrders :

ObjectQuery<SalesOrderHeader> onlineOrders =
      context.SalesOrderHeader
       .Where("it.OnlineOrderFlag = TRUE AND it.TotalDue > @ordercost",
         new ObjectParameter("ordercost", orderCost))
        .OrderBy("it.TotalDue DESC");

Comentários

A OrderBy Propriedade do EntityDataSource controle é uma cadeia de caracteres que representa uma expressão order by de uma consulta Entity SQL. Essa cadeia de caracteres é passada, sem modificação, para uma ObjectQuery<T> que é executada pelo Entity Framework. Essa consulta é a origem dos dados regulados pelo EntityDataSource controle. A cadeia de caracteres fornecida para a OrderBy propriedade usa o mesmo formato que a cadeia de caracteres que é passada para o OrderBy método de ObjectQuery<T> . Para obter exemplos de como usar a cláusula order by para ordenar os resultados da consulta, consulte como classificar dados.