Compartir a través de


EntityDataSource.AutoGenerateOrderByClause Propiedad

Definición

Obtiene o establece un valor que indica si el control EntityDataSource crea dinámicamente una cláusula ORDER BY basándose en valores de la colección 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

Valor de propiedad

Boolean

true si el control EntityDataSource crea la cláusula ORDER BY; de lo contrario, false. El valor predeterminado es false.

Excepciones

Cuando la propiedad AutoGenerateOrderByClause se establece en true y la propiedad OrderBy no es null.

Ejemplos

En el ejemplo siguiente se genera automáticamente la cláusula ORDER BY y se usa el valor de OrderByDropDownList para establecer el valor del parámetro.

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

En el ejemplo siguiente se genera automáticamente la cláusula ORDER BY y DefaultValue se usa el atributo del Parameter elemento para establecer el valor del parámetro.

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

Comentarios

Cuando la AutoGenerateOrderByClause propiedad del EntityDataSource control se establece en true , el control genera automáticamente una cláusula order by a partir del parámetro en el ParameterCollection asignado a la OrderByParameters propiedad. Esto elimina la necesidad de asignar explícitamente una cláusula ORDER BY a la OrderBy propiedad.

Si establece la AutoGenerateOrderByClause propiedad en true , no debe asignar explícitamente un valor a la OrderBy propiedad.

Se aplica a