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 come 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 è equivalente 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 EntityDataSource controllo è una stringa che rappresenta un'espressione ORDER BY di una query Entity SQL. Questa stringa viene passata, senza modifiche, a un oggetto ObjectQuery<T> eseguito da Entity Framework. Questa query è l'origine dei dati regolamentati dal EntityDataSource 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.