EntityDataSource.AutoGenerateOrderByClause Propiedad

Definición

Espacio de nombres:

System.Web.UI.WebControls

Ensamblado:

System.Web.Entity.dll

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

InvalidOperationException

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.