Sdílet prostřednictvím


LinqDataSource.AutoGenerateOrderByClause Vlastnost

Definice

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

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