EntityDataSource.AutoGenerateOrderByClause Właściwość

Definicja

Przestrzeń nazw:

System.Web.UI.WebControls

Zestaw:

System.Web.Entity.dll

Pobiera lub ustawia wartość wskazującą, czy EntityDataSource kontrolka dynamicznie tworzy klauzulę ORDER BY na podstawie wartości w kolekcji 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

Wartość właściwości

Boolean

true jeśli kontrolka EntityDataSource tworzy klauzulę ORDER BY; w przeciwnym razie false. Wartość domyślna to false.

Wyjątki

InvalidOperationException

Gdy właściwość jest ustawiona AutoGenerateOrderByClauseOrderBy na true i właściwość nie ma wartości null.

Przykłady

Poniższy przykład automatycznie generuje klauzulę ORDER BY i używa wartości OrderByDropDownList parametru , aby ustawić wartość 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>

Poniższy przykład automatycznie generuje klauzulę ORDER BY i używa DefaultValue atrybutu Parameter elementu, aby ustawić wartość 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>

Uwagi

Gdy AutoGenerateOrderByClause właściwość kontrolki EntityDataSource jest ustawiona na true, kontrolka automatycznie generuje klauzulę ORDER BY z parametru przypisanego ParameterCollectionOrderByParameters do właściwości. Eliminuje to konieczność jawnego przypisania klauzuli ORDER BY do OrderBy właściwości.

Jeśli ustawisz AutoGenerateOrderByClause właściwość na truewartość , nie należy jawnie przypisywać wartości do OrderBy właściwości.