LinqDataSource.OrderBy Propiedad

Definición

Espacio de nombres:

System.Web.UI.WebControls

Ensamblado:

System.Web.Extensions.dll

Obtiene o establece un valor que especifica qué campos se utilizan para ordenar los datos recuperados.

public:
 property System::String ^ OrderBy { System::String ^ get(); void set(System::String ^ value); };

public string OrderBy { get; set; }

member this.OrderBy : string with get, set

Public Property OrderBy As String

Valor de propiedad

String

Cadena que se usa para crear la cláusula Order By.

Ejemplos

En el ejemplo siguiente se devuelven datos en orden alfabético inverso en función de los valores de la Category propiedad .

<asp:LinqDataSource 
    ContextTypeName="ExampleDataContext" 
    TableName="Products" 
    OrderBy="Category Descending"
    ID="LinqDataSource1" 
    runat="server">
</asp:LinqDataSource>
<asp:GridView 
    AllowPaging="true"
    DataSourceID="LinqDataSource1"
    ID="GridView1" 
    runat="server">
</asp:GridView>

<asp:LinqDataSource 
    ContextTypeName="ExampleDataContext" 
    TableName="Products" 
    OrderBy="Category Descending"
    ID="LinqDataSource1" 
    runat="server">
</asp:LinqDataSource>
<asp:GridView 
    AllowPaging="true"
    DataSourceID="LinqDataSource1"
    ID="GridView1" 
    runat="server">
</asp:GridView>

Comentarios

Usa el OrderBy propiedad para especificar las propiedades de los datos devueltos a utilizar para ordenar. La propiedad para ordenar los datos debe existir en el origen de datos original, pero no tiene que incluirse en la Select propiedad . Puede agregar un espacio y Ascending, ASC, Descending, o DESC a una propiedad en el OrderBy cadena con el fin de especificar cómo se devuelven los datos ordenados.

Puede proporcionar más de una propiedad en la OrderBy propiedad separando cada propiedad mediante una coma. Por ejemplo, para ordenar por las propiedades denominadas LastName y FirstName, establezca la OrderBy propiedad en "LastName, FirstName".

Nota

Al usar el LinqDataSource control con SQL Server 2000 o SQL Server Compact 3.5 y la AutoPage propiedad se establece trueen , debe proporcionar un valor en la OrderBy propiedad . De forma predeterminada, la AutoPage propiedad es true. Si asigna un valor a la Select propiedad , también debe incluir todas las columnas de identidad en la lista de propiedades que se devuelven en la consulta.

Si la AutoSort propiedad está establecida trueen , un control enlazado a datos puede pasar una expresión de ordenación al LinqDataSource control en tiempo de ejecución. El LinqDataSource control aplicará la expresión de ordenación del control enlazado a datos después de aplicar la OrderBy propiedad . Por lo tanto, los datos se devuelven según la expresión de ordenación del control enlazado a datos.