EntityDataSource.AutoGenerateOrderByClause Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Obtém ou define um valor que indica se o controlo EntityDataSource cria dinamicamente uma cláusula ORDER BY com base em valores da OrderByParameters coleção.
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 Propriedade
true se o controlo EntityDataSource cria a cláusula ORDER BY; caso contrário, false. O valor predefinido é false.
Exceções
Quando a AutoGenerateOrderByClause propriedade está definida como true e a OrderBy propriedade não é nula.
Exemplos
O exemplo seguinte gera automaticamente a cláusula ORDER BY e usa o valor de para OrderByDropDownList definir o valor do 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>
O exemplo seguinte gera automaticamente a cláusula ORDER BY e usa o DefaultValue atributo do Parameter elemento para definir o valor do 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>
Observações
Quando a AutoGenerateOrderByClause propriedade do EntityDataSource controlo é definida para true, o controlo gera automaticamente uma cláusula ORDER BY a partir do parâmetro atribuído ParameterCollection à OrderByParameters propriedade. Isto elimina a necessidade de atribuir explicitamente uma cláusula ORDER BY à OrderBy propriedade.
Se definir a AutoGenerateOrderByClause propriedade como true, não deve atribuir explicitamente um valor à OrderBy propriedade.