LinqDataSource.AutoGenerateOrderByClause Vlastnost

Reference

Definice

Obor názvů:: System.Web.UI.WebControls

Sestavení:: System.Web.Extensions.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Získá nebo nastaví hodnotu, která označuje, zda LinqDataSource ovládací prvek dynamicky vytvoří klauzuli Order By na základě hodnot v kolekci 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

Hodnota vlastnosti

Boolean

true LinqDataSource pokud ovládací prvek vytvoří klauzuli Order By, jinak . false Výchozí formát je false.

Příklady

Následující příklad ukazuje ovládací prvek LinqDataSource s nastavenou AutoGenerateOrderByClause na true. Parametr je součástí OrderByParameters kolekce, která seřazuje data na základě názvu vlastnosti, kterou uživatel vybere z ovládacího prvku DropDownList .

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

Poznámky

Když nastavíte AutoGenerateOrderByClause vlastnost na true, LinqDataSource ovládací prvek dynamicky vytvoří klauzuli Order By, která je založená na hodnotách v kolekci OrderByParameters . Ovládací LinqDataSource prvek seřadí data podle prvního parametru a potom dodatečně seřadí data pro každý další parametr. Parametry, které obsahují null nebo prázdnou hodnotu, nejsou zahrnuty do klauzule Order By.

Vlastnost nenastavíte OrderBy , pokud AutoGenerateOrderByClause je nastavena na true, protože analyzátor dynamicky vytváří klauzuli Order By. Ovládací LinqDataSource prvek vyvolá výjimku, pokud je nastaven na AutoGenerateOrderByClausetrue a OrderBy vlastnost je přiřazena hodnoty.

Platí pro

Sdílet prostřednictvím