LinqDataSource.AutoGenerateOrderByClause Propiedad

Definición

Espacio de nombres:

System.Web.UI.WebControls

Ensamblado:

System.Web.Extensions.dll

Obtiene o establece un valor que indica si el control LinqDataSource crea de forma dinámica una cláusula Order By basándose en valores de la colección 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

Valor de propiedad

Boolean

true es si el LinqDataSource control crea la cláusula Order By; en caso contrario, falsees . De manera predeterminada, es false.

Ejemplos

En el ejemplo siguiente se muestra un LinqDataSource control con el AutoGenerateOrderByClause establecido en true. Se incluye un parámetro en la OrderByParameters colección que ordena los datos en función del nombre de propiedad que un usuario selecciona de un 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>

Comentarios

Al establecer la AutoGenerateOrderByClause propiedad trueen , el LinqDataSource control crea dinámicamente una cláusula Order By que se basa en los valores de la OrderByParameters colección. El LinqDataSource control ordena los datos por el primer parámetro y, a continuación, ordena los datos para cada parámetro adicional. Los parámetros que contienen null o un valor vacío no se incluyen en la cláusula Order By.

No establece la OrderBy propiedad cuando AutoGenerateOrderByClause se establece trueen , porque el analizador crea dinámicamente la cláusula Order By. El LinqDataSource control produce una excepción si se establece true en AutoGenerateOrderByClause y se asignan valores a la OrderBy propiedad .