LinqDataSource.AutoGenerateOrderByClause 속성

정의

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입니다.

예제

다음 예제에서는 로 설정된 true컨트롤을 AutoGenerateOrderByClause 보여줍니다LinqDataSource. 사용자가 컨트롤에서 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>

설명

속성을 true설정 AutoGenerateOrderByClause 하면 컨트롤이 컬렉션의 LinqDataSource 값을 OrderByParameters 기반으로 하는 Order By 절을 동적으로 만듭니다. 컨트롤은 LinqDataSource 첫 번째 매개 변수별로 데이터를 정렬한 다음 각 추가 매개 변수에 대한 데이터를 추가로 정렬합니다. Order By 절에 포함되거나 빈 값이 포함된 null 매개 변수는 포함되지 않습니다.

파서가 OrderBy Order By 절을 AutoGenerateOrderByClause 동적으로 만들므로 true설정되면 속성을 설정하지 않습니다. 컨트롤이 LinqDataSource 설정 true 되고 속성에 값이 AutoGenerateOrderByClause 할당되면 예외가 OrderBy throw됩니다.

적용 대상