EntityDataSource.AutoGenerateOrderByClause Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém ou define um valor que indica se o controle EntityDataSource cria dinamicamente uma cláusula ORDER BY com base nos valores na coleção 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 da propriedade
true se o controle EntityDataSource cria a cláusula ORDER BY; caso contrário, false. O valor padrão é false.
Exceções
Quando a propriedade AutoGenerateOrderByClause está definida como true e a propriedade OrderBy não é nula.
Exemplos
O exemplo a seguir gera automaticamente a cláusula ORDER BY e usa o valor de OrderByDropDownList para 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 a seguir 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>
Comentários
Quando a AutoGenerateOrderByClause Propriedade do EntityDataSource controle é definida como true , o controle gera automaticamente uma cláusula order by a partir do parâmetro no ParameterCollection atribuído à OrderByParameters propriedade. Isso elimina a necessidade de atribuir explicitamente uma cláusula ORDER BY à OrderBy propriedade.
Se você definir a AutoGenerateOrderByClause propriedade como true , não deverá atribuir explicitamente um valor à OrderBy propriedade.