EntityDataSource.OrderBy Właściwość

Definicja

Przestrzeń nazw:

System.Web.UI.WebControls

Zestaw:

System.Web.Entity.dll

Pobiera lub ustawia wyrażenie SQL jednostki, które określa sposób zamawiania wyników zapytania.

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

Wartość właściwości

String

Klauzula ORDER BY.

Przykłady

Znaczniki XML w poniższym przykładzie w pliku aspx pobiera wartość z kontrolki i przekazuje ją jako parametr do Where właściwości.

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

Poprzedni przykład XML jest odpowiednikiem następującej ObjectQuery<T> nazwy onlineOrders:

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

Uwagi

Właściwość OrderBy kontrolki EntityDataSource jest ciągiem reprezentującym wyrażenie ORDER BY zapytania Entity SQL. Ten ciąg jest przekazywany bez modyfikacji do ObjectQuery<T> elementu wykonywanego przez program Entity Framework. To zapytanie jest źródłem danych regulowanych przez kontrolkę EntityDataSource . Ciąg dostarczony do OrderBy właściwości używa tego samego formatu co ciąg przekazywany do OrderBy metody ObjectQuery<T>. Przykłady użycia klauzuli ORDER BY do zamawiania wyników zapytania można znaleźć w temacie How to: Sort Data (Instrukcje: sortowanie danych).