EntityDataSource.AutoGenerateOrderByClause Vlastnost

Definice

Obor názvů:

System.Web.UI.WebControls

Sestavení:

System.Web.Entity.dll

Získá nebo nastaví hodnotu, která označuje, zda EntityDataSource ovládací prvek dynamicky vytvoří ORDER BY klauzuli na základě hodnot v kolekci 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

Hodnota vlastnosti

Boolean

true EntityDataSource pokud ovládací prvek vytvoří klauzuli ORDER BY, v opačném případě . false Výchozí hodnota je false.

Výjimky

InvalidOperationException

AutoGenerateOrderByClause Pokud je vlastnost nastavena na true a OrderBy vlastnost není null.

Příklady

Následující příklad automaticky vygeneruje klauzuli ORDER BY a použije hodnotu OrderByDropDownList parametru k nastavení hodnoty parametru.

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

Následující příklad automaticky vygeneruje klauzuli ORDER BY a použije DefaultValue atribut elementu Parameter k nastavení hodnoty parametru.

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

Poznámky

AutoGenerateOrderByClause Pokud je vlastnost EntityDataSource ovládacího prvku nastavena na true, ovládací prvek automaticky vygeneruje klauzuli ORDER BY z parametru ParameterCollection v přiřazené OrderByParameters vlastnosti. Tím se eliminuje nutnost explicitně přiřadit klauzuli ORDER BY vlastnosti OrderBy .

Pokud nastavíte AutoGenerateOrderByClause vlastnost na truehodnotu , neměli byste explicitně přiřadit hodnotu vlastnosti OrderBy .