EntityDataSource.AutoGenerateOrderByClause Propriedade

Definição

Namespace:

System.Web.UI.WebControls

Assembly:

System.Web.Entity.dll

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

Public Property AutoGenerateOrderByClause As Boolean

Valor da propriedade

Boolean

true se o controle EntityDataSource cria a cláusula ORDER BY; caso contrário, false. O valor padrão é false.

Exceções

InvalidOperationException

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.