EntityDataSource.OrderBy Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Obtém ou define a expressão SQL Entity 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 de Propriedade
A cláusula ORDER BY.
Exemplos
A marcação XML no exemplo seguinte, num ficheiro .aspx, recupera um valor de um controlo e passa-o como 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 XML anterior é equivalente ao seguinte ObjectQuery<T> nomeado:onlineOrders
ObjectQuery<SalesOrderHeader> onlineOrders =
context.SalesOrderHeader
.Where("it.OnlineOrderFlag = TRUE AND it.TotalDue > @ordercost",
new ObjectParameter("ordercost", orderCost))
.OrderBy("it.TotalDue DESC");
Observações
A OrderBy propriedade do EntityDataSource controlo é uma cadeia que representa uma expressão ORDER BY de uma consulta SQL da Entidade. Esta cadeia é passada, sem modificações, para uma ObjectQuery<T> que é executada pelo Entity Framework. Esta consulta é a fonte dos dados regulados pelo EntityDataSource controlo. A cadeia fornecida à OrderBy propriedade usa o mesmo formato da cadeia que é passada ao OrderBy método de ObjectQuery<T>. Para exemplos de como usar a cláusula ORDER BY para ordenar os resultados da consulta, veja Como: Ordenar Dados.