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的属性排序，并将FirstNameOrderBy属性设置为“LastName， FirstName”。

备注

将LinqDataSource控件与 SQL Server 2000 或 SQL Server Compact 3.5 一起使用并且属性AutoPage设置为true时，必须在该属性中OrderBy提供值。 默认情况下，属性 AutoPage 为 true. 如果将值分配给 Select 该属性，则还必须在查询中返回的属性列表中包括所有标识列。

AutoSort如果该属性设置为 true，数据绑定控件可以在运行时将排序表达式传递给LinqDataSource控件。 该 LinqDataSource 控件在应用属性后，将从数据绑定控件应用 OrderBy 排序表达式。 因此，根据数据绑定控件中的排序表达式返回数据。