LinqDataSource.AutoGenerateOrderByClause Propriété

Définition

Espace de noms:

System.Web.UI.WebControls

Assembly:

System.Web.Extensions.dll

Obtient ou définit une valeur qui indique si le contrôle LinqDataSource 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 LinqDataSource contrôle crée la clause Order By ; sinon, false. La valeur par défaut est false.

Exemples

L’exemple suivant montre un LinqDataSource contrôle avec la AutoGenerateOrderByClause valeur truedéfinie sur . Un paramètre est inclus dans la OrderByParameters collection qui commande les données en fonction du nom de propriété qu’un utilisateur sélectionne à partir d’un DropDownList contrôle.

<asp:DropDownList AutoPostBack="true" ID="DropDownList1" runat="server">
    <asp:ListItem Value="Category"></asp:ListItem>
    <asp:ListItem Value="Price"></asp:ListItem>
</asp:DropDownList>
<asp:LinqDataSource 
    ContextTypeName="ExampleDataContext" 
    TableName="Products" 
    AutoGenerateOrderByClause="true"
    ID="LinqDataSource1" 
    runat="server">
    <OrderByParameters>
      <asp:ControlParameter
         ControlID="DropDownList1" 
         Type="String" />
    </OrderByParameters>
</asp:LinqDataSource>
<asp:GridView 
    DataSourceID="LinqDataSource1"
    ID="GridView1" 
    runat="server">
</asp:GridView>

<asp:DropDownList AutoPostBack="true" ID="DropDownList1" runat="server">
    <asp:ListItem Value="Category"></asp:ListItem>
    <asp:ListItem Value="Price"></asp:ListItem>
</asp:DropDownList>
<asp:LinqDataSource 
    ContextTypeName="ExampleDataContext" 
    TableName="Products" 
    AutoGenerateOrderByClause="true"
    ID="LinqDataSource1" 
    runat="server">
    <OrderByParameters>
      <asp:ControlParameter
         ControlID="DropDownList1" 
         Type="String" />
    </OrderByParameters>
</asp:LinqDataSource>
<asp:GridView 
    DataSourceID="LinqDataSource1"
    ID="GridView1" 
    runat="server">
</asp:GridView>

Remarques

Lorsque vous définissez la AutoGenerateOrderByClause propriété truesur , le LinqDataSource contrôle crée dynamiquement une clause Order By basée sur les valeurs de la OrderByParameters collection. Le LinqDataSource contrôle trie les données par le premier paramètre, puis trie les données pour chaque paramètre supplémentaire. Les paramètres qui contiennent null ou une valeur vide ne sont pas inclus dans la clause Order By.

Vous ne définissez pas la OrderBy propriété lorsque la AutoGenerateOrderByClause valeur est définie true, car l’analyseur crée dynamiquement la clause Order By. Le LinqDataSource contrôle lève une exception si la AutoGenerateOrderByClause valeur est définie true et si la OrderBy propriété est affectée à des valeurs.