LinqDataSource.OrderBy Eigenschap

Definitie

Naamruimte:
System.Web.UI.WebControls
Assembly:
System.Web.Extensions.dll

Hiermee haalt u een waarde op die aangeeft welke velden worden gebruikt voor het ordenen van de opgehaalde gegevens.

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

Waarde van eigenschap

String

Een tekenreeks die wordt gebruikt om de component Order By te maken.

Voorbeelden

In het volgende voorbeeld worden gegevens in omgekeerde alfabetische volgorde geretourneerd op basis van waarden in de Category eigenschap.

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

Opmerkingen

U gebruikt de OrderBy eigenschap om op te geven welke eigenschappen van de geretourneerde gegevens moeten worden gebruikt voor sorteren. De eigenschap voor het sorteren van de gegevens moet aanwezig zijn in de oorspronkelijke gegevensbron, maar deze hoeft niet in de Select eigenschap te worden opgenomen. U kunt een spatie en Ascending, ASCof DescendingDESC aan een eigenschap in de OrderBy tekenreeks toevoegen om op te geven hoe de geordende gegevens worden geretourneerd.

U kunt meer dan één eigenschap in de OrderBy eigenschap opgeven door elke eigenschap te scheiden met behulp van een komma. Als u bijvoorbeeld wilt orden op eigenschappen met de naam LastName en FirstNamestelt u de OrderBy eigenschap in op 'LastName, FirstName'.

Note

Wanneer u het besturingselement LinqDataSource gebruikt met SQL Server 2000 of SQL Server Compact 3.5 en de eigenschap AutoPage is ingesteld op true, moet u een waarde opgeven in de eigenschap OrderBy. De eigenschap AutoPage is standaard true. Als u een waarde aan de Select eigenschap toewijst, moet u ook alle identiteitskolommen opnemen in de lijst met eigenschappen die in de query worden geretourneerd.

Als de AutoSort eigenschap is ingesteld op true, kan een gegevensgebonden besturingselement tijdens runtime een sorteerexpressie doorgeven aan het LinqDataSource besturingselement. Het LinqDataSource besturingselement past de sorteerexpressie toe vanuit het besturingselement voor gegevens nadat de OrderBy eigenschap is toegepast. Daarom worden de gegevens geretourneerd volgens de sorteerexpressie van het besturingselement voor gegevens.

Van toepassing op