LinqDataSource.OrderBy Proprietà

Definizione

Spazio dei nomi:

System.Web.UI.WebControls

Assembly:

System.Web.Extensions.dll

Ottiene o imposta un valore che specifica quali campi vengono utilizzati per ordinare i dati recuperati.

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

Valore della proprietà

String

Stringa utilizzata per creare la clausola Order By.

Esempio

Nell'esempio seguente vengono restituiti dati in ordine alfabetico inverso in base ai valori nella Category proprietà .

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

Commenti

Utilizzare la OrderBy proprietà per specificare le proprietà dei dati restituiti da utilizzare per l'ordinamento. La proprietà per l'ordinamento dei dati deve esistere nell'origine dati originale, ma non deve essere inclusa nella Select proprietà . È possibile aggiungere uno spazio e Ascending, ASC, Descendingo DESC a una proprietà nella OrderBy stringa per specificare la modalità di restituzione dei dati ordinati.

È possibile specificare più proprietà nella OrderBy proprietà separando ogni proprietà usando una virgola. Ad esempio, per ordinare in base alle proprietà denominate LastName e FirstName, impostare la OrderBy proprietà su "LastName, FirstName".

Nota

Quando si utilizza il LinqDataSource controllo con SQL Server 2000 o SQL Server Compact 3.5 e la AutoPage proprietà è impostata su true, è necessario specificare un valore nella OrderBy proprietà . Per impostazione predefinita, la AutoPage proprietà è true. Se si assegna un valore alla Select proprietà , è necessario includere anche tutte le colonne Identity nell'elenco di proprietà restituite nella query.

Se la AutoSort proprietà è impostata su true, un controllo associato a dati può passare un'espressione di ordinamento al LinqDataSource controllo in fase di esecuzione. Il LinqDataSource controllo applicherà l'espressione di ordinamento dal controllo associato a dati dopo l'applicazione della OrderBy proprietà . Pertanto, i dati vengono restituiti in base all'espressione di ordinamento dal controllo associato a dati.