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 必要はありません。 順序付けされたデータを返す方法を指定するために、文字列内OrderByのプロパティにスペースと Ascending、、ASC、、Descending``DESCを追加できます。

コンマを使用して各プロパティを OrderBy 区切ることで、プロパティに複数のプロパティを指定できます。 たとえば、名前付きのプロパティで並べ替 LastName え、プロパティ FirstNameを OrderBy "LastName, FirstName" に設定します。

注意

SQL Server 2000 または SQL Server Compact 3.5 でコントロールを使用LinqDataSourceし、プロパティがAutoPage設定trueされている場合は、プロパティに値をOrderBy指定する必要があります。 既定では、プロパティは AutoPage true. プロパティに値を Select 割り当てる場合は、クエリで返されるプロパティの一覧にすべての ID 列も含める必要があります。

プロパティが AutoSort 設定 trueされている場合、データ バインド コントロールは実行時に並べ替え式をコントロールに LinqDataSource 渡すことができます。 コントロールは LinqDataSource 、プロパティを適用した後、データ バインド コントロールから並べ替え式を OrderBy 適用します。 したがって、データは、データ バインド コントロールの並べ替え式に従って返されます。