LinqDataSource.AutoGenerateOrderByClause Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает значение, которое указывает, создает ли элемент управления 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
Значение свойства
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 присвоены значения.