LinqDataSource.OrderByParameters プロパティ

定義

名前空間:

System.Web.UI.WebControls

アセンブリ:

System.Web.Extensions.dll

Order By 句の作成に使用されるパラメーターのコレクションを取得します。

public:
 property System::Web::UI::WebControls::ParameterCollection ^ OrderByParameters { System::Web::UI::WebControls::ParameterCollection ^ get(); };

[System.ComponentModel.Browsable(false)]
[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)]
public System.Web.UI.WebControls.ParameterCollection OrderByParameters { get; }

[<System.ComponentModel.Browsable(false)>]
[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)>]
member this.OrderByParameters : System.Web.UI.WebControls.ParameterCollection

Public ReadOnly Property OrderByParameters As ParameterCollection

プロパティ値

ParameterCollection

Order By 句の作成に使用されるパラメーター。

属性

BrowsableAttribute PersistenceModeAttribute

例

次の例は、LinqDataSource プロパティが AutoGenerateOrderByClause に設定された true コントロールを示したものです。 ユーザーがコントロールから選択したプロパティ名に基づいてデータを並べ替えるパラメーターがコレクションに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>

注釈

コントロールは LinqDataSource 、コレクション内のパラメーターを OrderByParameters 使用して、実行時に Order By 句を作成します。 通常、プロパティは AutoGenerateOrderByClause 、コレクションにパラメーターを true 追加するときに設定します OrderByParameters 。 プロパティが AutoGenerateOrderByClause 設定 trueされている場合、コレクション内の各パラメーターは、コレクションで OrderByParameters 指定されているシーケンスの Order By 句に OrderByParameters 追加されます。 プロパティが AutoGenerateOrderByClause 指定されている場合、パラメーターは true順番に適用され、プレースホルダーと一致しないため、名前を付ける必要はありません。

Order By 句で実行時に値を設定する必要がない場合は、コレクションを OrderByParameters 使用する必要はありません。 プロパティ内のデータの順序付けに使用するフィールドを OrderBy 定義できます。 たとえば、並べ替えられた LastNameデータベース テーブルから値を返すには、パラメーターを指定せずに "LastName" に設定 OrderBy します。

コレクション内のパラメーターを OrderByParameters 設定し、パラメーターをプロパティ内 OrderBy のプレースホルダーと一致させることができますが、この方法ではアプリケーションが制限されています。 この方法を使用する場合、コレクション内の OrderByParameters パラメーターは列名を表すことができません。 パラメーターを値に設定し、その値をプロパティ内の値と比較できます。 たとえば、プロパティ内の値がパラメーターで表される実行時の値より小さいかどうかに基づいてデータを並べ替えることができます。