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보여줍니다. 사용자가 컨트롤에서 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>

설명

컨트롤은 LinqDataSource 컬렉션의 매개 변수를 OrderByParameters 사용하여 런타임에 Order By 절을 만듭니다. 일반적으로 컬렉션에 매개 변수 OrderByParameters 를 AutoGenerateOrderByClause true 추가할 때 속성을 설정합니다. 속성이 AutoGenerateOrderByClause 설정 true되면 컬렉션의 OrderByParameters 각 매개 변수가 컬렉션에 지정된 시퀀스의 Order By 절에 OrderByParameters 추가됩니다. 속성이 AutoGenerateOrderByClause 있으면 true매개 변수가 순서대로 적용되고 자리 표시자와 일치하지 않으므로 매개 변수의 이름을 지정할 필요가 없습니다.

Order By 절에서 런타임에 값을 설정할 필요가 없는 경우 컬렉션을 사용할 OrderByParameters 필요가 없습니다. 속성의 데이터 OrderBy 순서 지정에 사용할 필드를 정의할 수 있습니다. 예를 들어 순서가 지정된 LastName데이터베이스 테이블의 값을 반환하려면 매개 변수 없이 "LastName"으로 설정합니다 OrderBy .

매개 변수를 설정할 수 있습니다 합니다 OrderByParameters 컬렉션의 자리 표시자에 매개 변수와 일치 하 고는 OrderBy 속성인 있지만이 방법은 애플리케이션을 제한적입니다. 이 방법을 사용하면 컬렉션의 매개 변수가 OrderByParameters 열 이름을 나타낼 수 없습니다. 매개 변수를 값으로 설정한 다음 해당 값을 속성의 값과 비교할 수 있습니다. 예를 들어 속성의 값이 매개 변수가 나타내는 런타임 값보다 작은지 여부에 따라 데이터를 정렬할 수 있습니다.