LinqDataSource.AutoGenerateOrderByClause Egenskap
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
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.