LinqDataSource.OrderBy 屬性

定義

命名空間:

System.Web.UI.WebControls

組件:

System.Web.Extensions.dll

取得或設定值，這個值指定用於對擷取之資料進行排序的欄位。

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

屬性值

String

用來建立 Order By 子句的字串。

範例

下列範例會根據 屬性中的 Category 值，以反向字母順序傳回資料。

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

備註

您可以使用 OrderBy 屬性來指定傳回資料中要用於排序的屬性。 排序資料的屬性必須存在於原始資料來源中，但不需要包含在 屬性中 Select 。 您可以將空格和 Ascending 、 ASC 、 Descending 或 DESC 加入字串中的 OrderBy 屬性，以指定如何傳回已排序的資料。

您可以在 屬性中提供多個屬性， OrderBy 方法是使用逗號分隔每個屬性。 例如，若要依名為 LastName 和 FirstName 的屬性排序，請將 OrderBy 屬性設定為 「LastName， FirstName」。

注意

當您使用 LinqDataSource 控制項搭配 SQL Server 2000 或 SQL Server Compact 3.5，且 AutoPage 屬性設定 true 為 時，您必須在 OrderBy 屬性中提供值。 根據預設， AutoPage 屬性為 true 。 如果您將值指派給 Select 屬性，您也必須在查詢中傳回的屬性清單中包含所有識別資料行。

AutoSort如果 屬性設定 true 為 ，則資料繫結控制項可以在執行時間將排序運算式傳遞至 LinqDataSource 控制項。 控制項 LinqDataSource 會在套用 屬性之後，從資料繫結控制項套用 OrderBy 排序運算式。 因此，資料會根據資料繫結控制項的排序運算式傳回。