LinqDataSource.OrderByParameters プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
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.ParameterCollectionPublic ReadOnly Property OrderByParameters As ParameterCollectionプロパティ値
Order By 句の作成に使用されるパラメーター。
- 属性
例
次の例は、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 パラメーターは列名を表すことができません。 パラメーターを値に設定し、その値をプロパティ内の値と比較できます。 たとえば、プロパティ内の値がパラメーターで表される実行時の値より小さいかどうかに基づいてデータを並べ替えることができます。