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 ，控件将自动从 ParameterCollection 分配给属性的中的参数生成 ORDER by 子句 OrderByParameters 。 这样就无需显式地将 ORDER BY 子句分配给 OrderBy 属性。

如果将属性设置 AutoGenerateOrderByClause 为 true ，则不应显式将值分配给 OrderBy 属性。