EntityDataSource.AutoGenerateOrderByClause Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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, setPublic Property AutoGenerateOrderByClause As BooleanValor de propiedad
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.