LinqDataSource.AutoGenerateOrderByClause 屬性

定義

命名空間:

System.Web.UI.WebControls

組件:

System.Web.Extensions.dll

取得或設定值，指出 LinqDataSource 控制項是否會根據 OrderByParameters 集合中的值，動態建立 ORDER BY 子句。

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

屬性值

Boolean

true LinqDataSource如果控制項建立 Order By 子句，則為 ， false 否則為 。 預設為 false。

範例

下列範例顯示設定 LinqDataSource 為 true 的 AutoGenerateOrderByClause 控制項。 參數包含在集合中 OrderByParameters ，該集合會根據使用者從 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>

備註

當您將 AutoGenerateOrderByClause 屬性設定為 true 時， LinqDataSource 控制項會根據集合中的 OrderByParameters 值動態建立 Order By 子句。 控制項會 LinqDataSource 依第一個參數排序資料，然後額外排序每個額外參數的資料。 包含 null 或空值的參數不會包含在 Order By 子句中。

當 設定為 true 時 AutoGenerateOrderByClause ，您不會設定 OrderBy 屬性，因為剖析器會動態建立 Order By 子句。 如果 AutoGenerateOrderByClause 設定 true 為 ，且 屬性已指派值， OrderBy 控制項 LinqDataSource 就會擲回例外狀況。