LinqDataSource.OrderBy Eigenschaft

Definition

Namespace:

System.Web.UI.WebControls

Assembly:

System.Web.Extensions.dll

Ruft einen Wert ab, der die zum Anordnen der abgerufenen Daten verwendeten Felder angibt, oder legt diesen fest.

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

Eigenschaftswert

String

Eine Zeichenfolge, die zum Erstellen der Order By-Klausel verwendet wird.

Beispiele

Im folgenden Beispiel werden Daten in umgekehrter alphabetischer Reihenfolge basierend auf Werten in der Category Eigenschaft zurückgegeben.

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

Hinweise

Sie verwenden die OrderBy Eigenschaft, um anzugeben, welche Eigenschaften aus den zurückgegebenen Daten zum Sortieren verwendet werden sollen. Die Eigenschaft zum Sortieren der Daten muss in der ursprünglichen Datenquelle vorhanden sein, muss jedoch nicht in die Select Eigenschaft einbezogen werden. Sie können ein Leerzeichen und Ascending, , ASCoder Descending``DESC eine Eigenschaft in der OrderBy Zeichenfolge hinzufügen, um anzugeben, wie die sortierten Daten zurückgegeben werden.

Sie können mehrere Eigenschaften in der OrderBy Eigenschaft bereitstellen, indem Sie jede Eigenschaft mithilfe eines Kommas trennen. Legen Sie beispielsweise die OrderBy Eigenschaft auf "LastName, FirstName" fest, um die Reihenfolge nach Eigenschaften namens LastName und FirstName.

Hinweis

Wenn Sie das LinqDataSource Steuerelement mit SQL Server 2000 oder SQL Server Compact 3.5 verwenden und die AutoPage Eigenschaft auf true"3.5" festgelegt ist, müssen Sie einen Wert in der OrderBy Eigenschaft angeben. Standardmäßig ist truedie AutoPage Eigenschaft . Wenn Sie der Eigenschaft einen Wert zuweisen, müssen Sie auch alle Identitätsspalten in die Liste der Eigenschaften einschließen, die in der Select Abfrage zurückgegeben werden.

Wenn die AutoSort Eigenschaft auf truefestgelegt ist, kann ein datengebundenes Steuerelement einen Sortierausdruck an das LinqDataSource Steuerelement zur Laufzeit übergeben. Das LinqDataSource Steuerelement wendet den Sortierausdruck aus dem datengebundenen Steuerelement an, nachdem die Eigenschaft angewendet OrderBy wurde. Daher werden die Daten gemäß dem Sortierausdruck aus dem datengebundenen Steuerelement zurückgegeben.