EntityDataSource.OrderBy Proprietà

Definizione

Spazio dei nomi:

System.Web.UI.WebControls

Assembly:

System.Web.Entity.dll

Ottiene o imposta l'espressione Entity SQL che specifica il modo in cui ordinare i risultati della query.

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

Valore della proprietà

String

Clausola ORDER BY.

Esempio

Il markup XML nell'esempio seguente, in un file aspx, recupera un valore da un controllo e lo passa come parametro alla Where proprietà.

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

L'esempio XML precedente equivale al seguente ObjectQuery<T> denominato onlineOrders:

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

Commenti

La OrderBy proprietà del controllo è una stringa che rappresenta un'espressione EntityDataSourceORDER BY di una query Entity SQL. Questa stringa viene passata, senza modifica, a un ObjectQuery<T> oggetto eseguito da Entity Framework. Questa query è l'origine EntityDataSource dei dati regolamentati dal controllo. La stringa fornita alla OrderBy proprietà usa lo stesso formato della stringa passata al OrderBy metodo di ObjectQuery<T>. Per esempi di come usare la clausola ORDER BY per ordinare i risultati delle query, vedere Procedura: Ordinare i dati.