LinqDataSource.AutoGenerateOrderByClause Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het LinqDataSource besturingselement dynamisch een Order By-component maakt op basis van waarden in de OrderByParameters verzameling.
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
Waarde van eigenschap
true als het LinqDataSource besturingselement de Component Order By maakt; falseanders. De standaardwaarde is false.
Voorbeelden
In het volgende voorbeeld ziet u een LinqDataSource besturingselement met de AutoGenerateOrderByClause set op true. Een parameter wordt opgenomen in de OrderByParameters verzameling waarmee de gegevens worden besteld op basis van de eigenschapsnaam die een gebruiker selecteert in een DropDownList besturingselement.
<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>
Opmerkingen
Wanneer u de AutoGenerateOrderByClause eigenschap trueinstelt op, maakt het LinqDataSource besturingselement dynamisch een Order By-component die is gebaseerd op de waarden in de OrderByParameters verzameling. Het LinqDataSource besturingselement sorteert de gegevens op de eerste parameter en sorteert vervolgens de gegevens voor elke extra parameter. Parameters die of een lege waarde bevatten null , worden niet opgenomen in de component Order By.
U stelt de OrderBy eigenschap niet in wanneer de AutoGenerateOrderByClause eigenschap is ingesteld op true, omdat de parser dynamisch de component Order By maakt. Het LinqDataSource besturingselement genereert een uitzondering als de AutoGenerateOrderByClause eigenschap is ingesteld true op en de OrderBy eigenschap wordt toegewezen waarden.