EntityDataSource.OrderBy 屬性

定義

命名空間:

System.Web.UI.WebControls

組件:

System.Web.Entity.dll

取得或設定 Entity SQL 運算式，這個運算式會指定如何排列查詢結果。

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

屬性值

String

ORDER BY 子句。

範例

下列範例中的 XML 標記在 .aspx 檔案中，會從 控制項擷取值，並將它當做參數傳遞至 Where 屬性。

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

先前的 XML 範例相當於下列 ObjectQuery<T> 名為 onlineOrders ：

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

備註

OrderBy控制項的 EntityDataSource 屬性是字串，代表 Entity SQL 查詢的ORDER BY運算式。 此字串會傳遞至 ObjectQuery<T> Entity Framework 所執行的 ，而不需修改。 此查詢是控制項所管制 EntityDataSource 之資料的來源。 提供給 屬性的 OrderBy 字串會使用與傳遞至 OrderBy 方法 ObjectQuery<T> 之字串相同的格式。 如需如何使用 ORDER BY 子句排序查詢結果的範例，請參閱 如何：排序資料。