LinqDataSource.AutoGenerateOrderByClause Свойство

Определение

Возвращает или задает значение, которое указывает, создает ли элемент управления LinqDataSource динамически предложение ORDER BY на основе значений в коллекции OrderByParameters.Gets or sets a value that indicates whether the LinqDataSource control dynamically creates an Order By clause based on values in the OrderByParameters collection.

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

Значение свойства

true, если элемент управления LinqDataSource создает предложение ORDER BY; в противном случае false.true if the LinqDataSource control creates the Order By clause; otherwise, false. Значение по умолчанию — false.The default is false.

Примеры

В следующем примере показан элемент управления LinqDataSource с AutoGenerateOrderByClause, для которого задано значение true.The following example shows a LinqDataSource control with the AutoGenerateOrderByClause set to true. Параметр включается в коллекцию OrderByParameters, которая упорядочивает данные на основе имени свойства, которое пользователь выбирает из элемента управления DropDownList.A parameter is included in the OrderByParameters collection that orders the data based on the property name that a user selects from a DropDownList control.

<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>

Комментарии

Если для свойства AutoGenerateOrderByClause задано значение true, элемент управления LinqDataSource динамически создает предложение ORDER BY, основанное на значениях в коллекции OrderByParameters.When you set the AutoGenerateOrderByClause property to true, the LinqDataSource control dynamically creates an Order By clause that is based on the values in the OrderByParameters collection. Элемент управления LinqDataSource сортирует данные по первому параметру, а затем дополнительно сортирует данные для каждого дополнительного параметра.The LinqDataSource control sorts the data by the first parameter and then additionally sorts the data for each additional parameter. Параметры, содержащие null или пустое значение, не включаются в предложение ORDER BY.Parameters that contain null or an empty value are not included in the Order By clause.

Свойство OrderBy не задается, если AutoGenerateOrderByClause имеет значение true, так как средство синтаксического анализа динамически создает предложение ORDER BY.You do not set the OrderBy property when the AutoGenerateOrderByClause is set to true, because the parser dynamically creates the Order By clause. Элемент управления LinqDataSource создает исключение, если AutoGenerateOrderByClause имеет значение true и свойству OrderBy присваиваются значения.The LinqDataSource control throws an exception if the AutoGenerateOrderByClause is set to true and the OrderBy property is assigned values.

Применяется к