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 に設定されたコントロールをAutoGenerateOrderByClausetrue示しています。 ユーザーがコントロールから選択したプロパティ名に基づいてデータを並べ替えるパラメーターがコレクションにDropDownList含まれますOrderByParameters。

<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 値に基づいて Order By 句を動的に OrderByParameters 作成します。 コントロールは LinqDataSource 、最初のパラメーターでデータを並べ替え、さらに追加の各パラメーターのデータを並べ替えます。 または空の値を含む null パラメーターは、Order By 句には含まれません。

パーサーは Order By 句をOrderBy動的に作成するため、 が にtrue設定されている場合AutoGenerateOrderByClauseは、 プロパティを設定しません。 が LinqDataSource にtrue設定され、 プロパティに値が割り当てられている場合AutoGenerateOrderByClause、コントロールは例外をOrderByスローします。