EntityDataSource.AutoGenerateOrderByClause 屬性

定義

命名空間:

System.Web.UI.WebControls

組件:

System.Web.Entity.dll

取得或設定值，指出 EntityDataSource 控制項是否會根據 OrderByParameters 集合中的值，動態建立 ORDER BY 子句。

public:
 property bool AutoGenerateOrderByClause { bool get(); void set(bool value); };

public bool AutoGenerateOrderByClause { get; set; }

member this.AutoGenerateOrderByClause : bool with get, set

Public Property AutoGenerateOrderByClause As Boolean

屬性值

Boolean

如果 EntityDataSource 控制項會建立 ORDER BY 子句，則為 true；否則為 false。 預設值是 false。

例外狀況

InvalidOperationException

當 AutoGenerateOrderByClause 屬性設定為 true 且 OrderBy 屬性不是 Null 時。

範例

下列範例會自動產生 ORDER BY 子句，並使用 的值 OrderByDropDownList 來設定 參數的值。

<asp:DropDownList AutoPostBack="true" ID="OrderByDropDownList" runat="server">
    <asp:ListItem Value="TotalDue"></asp:ListItem>
    <asp:ListItem Value="OrderDate"></asp:ListItem>
</asp:DropDownList>

<asp:EntityDataSource ID="EntityDataSourceWithAutoGenOrderBy" runat="server"
ConnectionString="name=AdventureWorksEntities"
DefaultContainerName="AdventureWorksEntities"
EntitySetName="SalesOrderHeaders"
Select="it.SalesOrderID, it.TotalDue, it.OrderDate"
AutoGenerateOrderByClause="True">
<OrderByParameters>
    <asp:ControlParameter
    ControlID="OrderByDropDownList"/>
</OrderByParameters>
</asp:EntityDataSource>

下列範例會自動產生 ORDER BY 子句，並使用 DefaultValue 專案的 屬性 Parameter 來設定 參數的值。

<asp:EntityDataSource ID="EntityDataSourceWithAutoGenOrderBy" runat="server"
ConnectionString="name=AdventureWorksEntities"
DefaultContainerName="AdventureWorksEntities"
EntitySetName="SalesOrderHeaders"
Select="it.SalesOrderID, it.TotalDue, it.OrderDate"
AutoGenerateOrderByClause="True">
<OrderByParameters>
    <asp:Parameter
    DefaultValue="TotalDue"/>
</OrderByParameters>
</asp:EntityDataSource>

備註

AutoGenerateOrderByClause當 控制項的 EntityDataSource 屬性設定為 true 時，控制項會自動從指派給 OrderByParameters 屬性的參數產生 ParameterCollection ORDER BY 子句。 這不需要明確地將 ORDER BY 子句指派給 OrderBy 屬性。

如果您將 AutoGenerateOrderByClause 屬性設定為 true ，則不應該明確將值指派給 OrderBy 屬性。