EntityDataSource.AutoGenerateOrderByClause Свойство

Определение

Пространство имен:

System.Web.UI.WebControls

Сборка:

System.Web.Entity.dll

Возвращает или задает значение, которое указывает, создает ли элемент управления EntityDataSource динамически предложение ORDER BY на основе значений в коллекции OrderByParameters.

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

true, если элемент управления EntityDataSource создает предложение ORDER BY. В противном случае — 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>

Комментарии

Если свойству AutoGenerateOrderByClauseEntityDataSource элемента управления присвоено значение true, элемент управления автоматически создает предложение ORDER BY из параметра в свойстве ParameterCollection , назначенном свойству OrderByParameters . Это устраняет необходимость явного назначения предложения ORDER BY свойству OrderBy .

Если для свойства задано AutoGenerateOrderByClause значение true, не следует явно присваивать значение свойству OrderBy .