EntityDataSource.OrderBy Propiedad

Definición

Espacio de nombres:

System.Web.UI.WebControls

Ensamblado:

System.Web.Entity.dll

Obtiene o establece la expresión de Entity SQL que especifica cómo ordenar los resultados de la 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 propiedad

String

La cláusula ORDER BY.

Ejemplos

El marcado XML del ejemplo siguiente, en un archivo .aspx, recupera un valor de un control y lo pasa como parámetro a la Where propiedad .

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

El ejemplo XML anterior es equivalente a lo siguiente ObjectQuery<T> denominado onlineOrders:

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

Comentarios

La OrderBy propiedad del EntityDataSource control es una cadena que representa una expresión ORDER BY de una consulta Entity SQL. Esta cadena se pasa, sin modificaciones, a un ObjectQuery<T> objeto ejecutado por Entity Framework. Esta consulta es el origen de los datos regulados por el EntityDataSource control . La cadena proporcionada a la OrderBy propiedad usa el mismo formato que la cadena que se pasa al OrderBy método de ObjectQuery<T>. Para obtener ejemplos de cómo usar la cláusula ORDER BY para ordenar los resultados de la consulta, vea Cómo: Ordenar datos.