LinqDataSource.WhereParameters Properti

Definisi

Ruang nama:

System.Web.UI.WebControls

Rakitan:

System.Web.Extensions.dll

Mendapatkan kumpulan parameter yang digunakan untuk membuat klausa Where.

public:
 property System::Web::UI::WebControls::ParameterCollection ^ WhereParameters { 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 WhereParameters { get; }

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

Public ReadOnly Property WhereParameters As ParameterCollection

Nilai Properti

ParameterCollection

Kumpulan parameter yang digunakan untuk membuat klausa Where di Where properti .

Penerapan

WhereParameters

Atribut

BrowsableAttribute PersistenceModeAttribute

Contoh

Contoh berikut menunjukkan cara menggunakan WhereParameters koleksi untuk membuat klausa Where secara dinamis. LinqDataSource Kontrol mengembalikan semua rekaman dengan nilai di Price kolom yang lebih besar dari nilai yang dipilih oleh pengguna dalam DropDownList kontrol.

<asp:DropDownList AutoPostBack="true" ID="DropDownList1" runat="server">
    <asp:ListItem Value="0"></asp:ListItem>
    <asp:ListItem Value="25"></asp:ListItem>
    <asp:ListItem Value="100"></asp:ListItem>
    <asp:ListItem Value="400"></asp:ListItem>
</asp:DropDownList>
<asp:LinqDataSource 
    ContextTypeName="ExampleDataContext" 
    TableName="Products" 
    Where="Price>@UserPrice"
    ID="LinqDataSource1" 
    runat="server">
    <WhereParameters>
        <asp:ControlParameter 
            Name="UserPrice" 
            DefaultValue="0" 
            ControlID="DropDownList1" 
            Type="Int32" />
    </WhereParameters>
</asp:LinqDataSource>
<asp:GridView 
    DataSourceID="LinqDataSource1"
    ID="GridView1" 
    runat="server">
</asp:GridView>

<asp:DropDownList AutoPostBack="true" ID="DropDownList1" runat="server">
    <asp:ListItem Value="0"></asp:ListItem>
    <asp:ListItem Value="25"></asp:ListItem>
    <asp:ListItem Value="100"></asp:ListItem>
    <asp:ListItem Value="400"></asp:ListItem>
</asp:DropDownList>
<asp:LinqDataSource 
    ContextTypeName="ExampleDataContext" 
    TableName="Products" 
    Where="Price > @UserPrice"
    ID="LinqDataSource1" 
    runat="server">
    <WhereParameters>
        <asp:ControlParameter 
            Name="UserPrice" 
            DefaultValue="0" 
            ControlID="DropDownList1" 
            Type="Int32" />
    </WhereParameters>
</asp:LinqDataSource>
<asp:GridView 
    DataSourceID="LinqDataSource1"
    ID="GridView1" 
    runat="server">
</asp:GridView>

Keterangan

Kontrol LinqDataSource menggunakan parameter dalam WhereParameters koleksi untuk membuat klausa Where pada run time. Anda menambahkan parameter ke WhereParameters koleksi saat Anda ingin mengatur satu atau beberapa kondisi secara terprogram dalam klausa Where. Misalnya, Anda dapat mencari tabel database untuk rekaman dengan nama belakang yang sama dengan nilai TextBox kontrol. Dalam hal ini, Anda menambahkan parameter ke WhereParameters koleksi untuk nilai kotak teks.

Jika Anda tidak perlu menetapkan nilai pada waktu proses di klausa Where, Anda tidak perlu menggunakan WhereParameters koleksi. Anda dapat menentukan bidang yang akan diambil di Where properti . Misalnya, untuk mengembalikan nilai dari tabel database di mana LastName sama dengan "Adams" dalam markup, atur Where properti ke 'LastName = "Adams"' tanpa parameter apa pun.

Untuk mengatur nilai dalam WhereParameters koleksi, Anda menetapkan nama ke setiap parameter lalu menambahkan tempat penampung di properti untuk parameter tersebut Where . Dalam klausa Where, awali setiap nama parameter dengan simbol @.