EntityDataSource.AutoGenerateOrderByClause Proprietà

Definizione

Spazio dei nomi:

System.Web.UI.WebControls

Assembly:

System.Web.Entity.dll

Ottiene o imposta un valore che indica se il controllo EntityDataSource crea dinamicamente una clausola ORDER BY in base ai valori della raccolta 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

Valore della proprietà

Boolean

true se il controllo EntityDataSource crea la clausola ORDER BY; in caso contrario, false. Il valore predefinito è false.

Eccezioni

InvalidOperationException

Se la proprietà AutoGenerateOrderByClause è impostata su true e la proprietà OrderBy non è Null.

Esempio

Nell'esempio seguente viene generata automaticamente la clausola ORDER BY e viene utilizzato il valore di OrderByDropDownList per impostare il valore del parametro.

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

Nell'esempio seguente viene generata automaticamente la clausola ORDER BY e viene utilizzato l' DefaultValue attributo dell' Parameter elemento per impostare il valore del parametro.

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

Commenti

Quando la AutoGenerateOrderByClause proprietà del EntityDataSource controllo è impostata su true , il controllo genera automaticamente una clausola ORDER BY dal parametro nell'oggetto ParameterCollection assegnato alla OrderByParameters Proprietà. In questo modo si elimina la necessità di assegnare esplicitamente una clausola ORDER BY alla OrderBy Proprietà.

Se si imposta la AutoGenerateOrderByClause proprietà su true , è consigliabile non assegnare in modo esplicito un valore alla OrderBy Proprietà.