Språk

LinqDataSource.AutoGenerateOrderByClause Egenskap

Definition

Hämtar eller anger ett värde som anger om LinqDataSource kontrollen dynamiskt skapar en Order By-sats baserat på värden i OrderByParameters samlingen.

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

Egenskapsvärde

trueom kontrollen LinqDataSource skapar Order By-satsen, annars . false Standardvärdet är false.

Exempel

I följande exempel visas en LinqDataSource kontroll med värdet AutoGenerateOrderByClausetrue. En parameter ingår i samlingen OrderByParameters som beställer data baserat på egenskapsnamnet som en användare väljer från en DropDownList kontroll.

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

Kommentarer

När du anger AutoGenerateOrderByClause egenskapen till trueLinqDataSource skapar kontrollen dynamiskt en Order By-sats som baseras på värdena i OrderByParameters samlingen. Kontrollen LinqDataSource sorterar data efter den första parametern och sorterar sedan dessutom data för varje ytterligare parameter. Parametrar som innehåller null eller ett tomt värde ingår inte i Order By-satsen.

Du anger OrderBy inte egenskapen när AutoGenerateOrderByClause är inställd på true, eftersom parsern dynamiskt skapar Order By-satsen. Kontrollen LinqDataSource genererar ett undantag om AutoGenerateOrderByClause är inställt på true och egenskapen OrderBy tilldelas värden.

Gäller för