LinqDataSource.OrderBy Propriedade

Definição

Espaço de Nomes:
System.Web.UI.WebControls
Assemblagem:
System.Web.Extensions.dll

Obtém ou define um valor que especifica quais os campos 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 de Propriedade

String

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

Exemplos

O exemplo seguinte devolve dados por ordem alfabética inversa com base nos valores da 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>

Observações

Usas a OrderBy propriedade para especificar quais propriedades dos dados devolvidos usar para a ordenação. A propriedade para ordenar os dados deve existir na fonte original de dados, mas não tem de ser incluída na Select propriedade. Pode adicionar um espaço e Ascending, ASC, Descending, ou DESC a uma propriedade na OrderBy cadeia para especificar como os dados ordenados são devolvidos.

Pode fornecer mais do que uma propriedade OrderBy na propriedade separando cada uma com uma vírgula. Por exemplo, para ordenar por propriedades nomeadas LastName e FirstName, defina a OrderBy propriedade para "ApelidoNome, Primeiro Nome".

Note

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

Se a AutoSort propriedade for definida para true, um controlo limitado por dados pode passar uma expressão de ordenação ao LinqDataSource controlo em tempo de execução. O LinqDataSource controlo aplicará a expressão de ordenação do controlo data-bound depois de aplicar a OrderBy propriedade. Portanto, os dados são devolvidos de acordo com a expressão de ordenação do controlo data-bound.

Aplica-se a