LinqDataSource.OrderByParameters Properti

Definisi

Ruang nama:

System.Web.UI.WebControls

Rakitan:

System.Web.Extensions.dll

Mendapatkan kumpulan parameter yang digunakan untuk membuat klausa Order By.

public:
 property System::Web::UI::WebControls::ParameterCollection ^ OrderByParameters { System::Web::UI::WebControls::ParameterCollection ^ get(); };

[System.ComponentModel.Browsable(false)]
[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)]
public System.Web.UI.WebControls.ParameterCollection OrderByParameters { get; }

[<System.ComponentModel.Browsable(false)>]
[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)>]
member this.OrderByParameters : System.Web.UI.WebControls.ParameterCollection

Public ReadOnly Property OrderByParameters As ParameterCollection

Nilai Properti

ParameterCollection

Parameter yang digunakan untuk membuat klausa Order By.

Atribut

BrowsableAttribute PersistenceModeAttribute

Contoh

Contoh berikut menunjukkan LinqDataSource kontrol dengan properti yang AutoGenerateOrderByClause diatur ke true. Parameter disertakan dalam OrderByParameters koleksi yang mengurutkan data berdasarkan nama properti yang dipilih pengguna dari DropDownList kontrol.

<asp:DropDownList AutoPostBack="true" ID="DropDownList1" runat="server">
    <asp:ListItem Value="Category"></asp:ListItem>
    <asp:ListItem Value="Price"></asp:ListItem>
</asp:DropDownList>
<asp:LinqDataSource 
    ContextTypeName="ExampleDataContext" 
    TableName="Products" 
    AutoGenerateOrderByClause="true"
    ID="LinqDataSource1" 
    runat="server">
    <OrderByParameters>
      <asp:ControlParameter
         ControlID="DropDownList1" 
         Type="String" />
    </OrderByParameters>
</asp:LinqDataSource>
<asp:GridView 
    DataSourceID="LinqDataSource1"
    ID="GridView1" 
    runat="server">
</asp:GridView>

<asp:DropDownList AutoPostBack="true" ID="DropDownList1" runat="server">
    <asp:ListItem Value="Category"></asp:ListItem>
    <asp:ListItem Value="Price"></asp:ListItem>
</asp:DropDownList>
<asp:LinqDataSource 
    ContextTypeName="ExampleDataContext" 
    TableName="Products" 
    AutoGenerateOrderByClause="true"
    ID="LinqDataSource1" 
    runat="server">
    <OrderByParameters>
      <asp:ControlParameter
         ControlID="DropDownList1" 
         Type="String" />
    </OrderByParameters>
</asp:LinqDataSource>
<asp:GridView 
    DataSourceID="LinqDataSource1"
    ID="GridView1" 
    runat="server">
</asp:GridView>

Keterangan

Kontrol LinqDataSource menggunakan parameter dalam OrderByParameters koleksi untuk membuat klausa Order By pada waktu proses. Biasanya Anda mengatur properti ke AutoGenerateOrderByClausetrue saat Anda menambahkan parameter ke OrderByParameters koleksi. AutoGenerateOrderByClause Ketika properti diatur ke true, setiap parameter dalam OrderByParameters koleksi ditambahkan ke klausul Order By dalam urutan yang ditentukan dalam OrderByParameters koleksi. AutoGenerateOrderByClause Ketika properti adalah true, parameter tidak harus dinamai karena diterapkan secara berurutan dan tidak cocok dengan tempat penampung.

Jika Anda tidak perlu menetapkan nilai pada waktu proses dalam klausa Order By, Anda tidak perlu menggunakan OrderByParameters koleksi. Anda dapat menentukan bidang yang akan digunakan untuk mengurutkan data dalam OrderBy properti . Misalnya, untuk mengembalikan nilai dari tabel database yang diurutkan menurut LastName, atur OrderBy ke "LastName" tanpa parameter apa pun.

Anda dapat mengatur parameter dalam OrderByParameters koleksi dan mencocokkan parameter dengan tempat penampung di OrderBy properti, tetapi pendekatan ini memiliki aplikasi terbatas. Saat Anda menggunakan pendekatan ini, parameter dalam OrderByParameters koleksi tidak dapat mewakili nama kolom. Anda dapat mengatur parameter ke nilai lalu membandingkan nilai tersebut dengan nilai dalam properti. Misalnya, Anda dapat mengurutkan data berdasarkan apakah nilai dalam properti kurang dari nilai run-time yang diwakili oleh parameter .