LinqDataSource.OrderBy Propriedade

Definição

Namespace:

System.Web.UI.WebControls

Assembly:

System.Web.Extensions.dll

Obtém ou define um valor que especifica quais campos são usados para ordenar os dados 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 da propriedade

String

Uma cadeia de caracteres que é usada para criar a cláusula Order By.

Exemplos

O exemplo a seguir retorna dados em ordem alfabética inversa com base em valores na Category propriedade.

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

Comentários

Use a OrderBy propriedade para especificar quais propriedades dos dados retornados usar para classificação. A propriedade para classificar os dados deve existir na fonte de dados original, mas não precisa ser incluída na Select propriedade. Você pode adicionar um espaço e Ascending, ASC, Descendingou DESC a uma propriedade na OrderBy cadeia de caracteres, a fim de especificar como os dados ordenados são retornados.

Você pode fornecer mais de uma propriedade na OrderBy propriedade separando cada propriedade usando uma vírgula. Por exemplo, para ordenar por propriedades nomeadas LastName e FirstName, defina a OrderBy propriedade como "LastName, FirstName".

Observação

Quando você usa o LinqDataSource controle com SQL Server 2000 ou SQL Server Compact 3.5 e a AutoPage propriedade está definida comotrue, você deve fornecer um valor na OrderBy propriedade. Por padrão, a AutoPage propriedade é true. Se você atribuir um valor à Select propriedade, também deverá incluir todas as colunas de identidade na lista de propriedades retornadas na consulta.

Se a AutoSort propriedade estiver definida como, um controle associado a truedados poderá passar uma expressão de classificação para o LinqDataSource controle em tempo de execução. O LinqDataSource controle aplicará a expressão de classificação do controle associado a dados depois de aplicar a OrderBy propriedade. Portanto, os dados são retornados de acordo com a expressão de classificação do controle associado a dados.