EntityDataSource.AutoGenerateOrderByClause Propriété

Définition

Espace de noms:

System.Web.UI.WebControls

Assembly:

System.Web.Entity.dll

Obtient ou définit une valeur qui indique si le contrôle EntityDataSource crée dynamiquement une clause ORDER BY en fonction des valeurs dans la collection 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

Valeur de propriété

Boolean

true si le EntityDataSource contrôle crée la clause ORDER BY, sinon false. La valeur par défaut est false.

Exceptions

InvalidOperationException

Si la propriété AutoGenerateOrderByClause est définie sur true et si la propriété OrderBy n’est pas Null.

Exemples

L’exemple suivant génère automatiquement la clause ORDER BY et utilise la valeur de OrderByDropDownList pour définir la valeur du paramètre.

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

L’exemple suivant génère automatiquement la clause ORDER BY et utilise l’attribut DefaultValue de l’élément Parameter pour définir la valeur du paramètre.

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

Remarques

Lorsque la AutoGenerateOrderByClause propriété du EntityDataSource contrôle est définie sur true, le contrôle génère automatiquement une clause ORDER BY à partir du paramètre dans le ParameterCollection affecté à la OrderByParameters propriété . Cela élimine la nécessité d’affecter explicitement une clause ORDER BY à la OrderBy propriété.

Si vous définissez la propriété sur AutoGenerateOrderByClausetrue, vous ne devez pas affecter explicitement une valeur à la OrderBy propriété.