LinqDataSource.AutoGenerateOrderByClause Свойство

Определение

Пространство имен:

System.Web.UI.WebControls

Сборка:

System.Web.Extensions.dll

Возвращает или задает значение, которое указывает, создает ли элемент управления LinqDataSource динамически предложение ORDER BY на основе значений в коллекции OrderByParameters.

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. Параметр включается в коллекцию 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>

Комментарии

Если для свойства задано значение AutoGenerateOrderByClausetrue, LinqDataSource элемент управления динамически создает предложение Order By, основанное на значениях в OrderByParameters коллекции. Элемент LinqDataSource управления сортирует данные по первому параметру, а затем дополнительно сортирует данные для каждого дополнительного параметра. Параметры, содержащие null или пустое значение, не включаются в предложение Order By.

Свойство не устанавливается OrderBy , если AutoGenerateOrderByClause задано значение true, так как средство синтаксического анализа динамически создает предложение Order By. Элемент LinqDataSource управления создает исключение, если свойству AutoGenerateOrderByClause присвоено значение true , а свойству OrderBy присвоены значения.