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 Значение , falseесли элемент управления создает предложение ORDER BY; в противном случае . Значение по умолчанию — 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значение, элемент управления автоматически создает предложение ORDER BY из параметра в назначенном ParameterCollection свойствеOrderByParameters. Это устраняет необходимость явного назначения предложения ORDER BY свойству OrderBy .

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