LinqDataSource.SelectParameters Properti
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mendapatkan kumpulan parameter yang digunakan selama operasi pengambilan data.
public:
property System::Web::UI::WebControls::ParameterCollection ^ SelectParameters { 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 SelectParameters { get; }
[<System.ComponentModel.Browsable(false)>]
[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)>]
member this.SelectParameters : System.Web.UI.WebControls.ParameterCollection
Public ReadOnly Property SelectParameters As ParameterCollection
Nilai Properti
Parameter yang digunakan untuk membuat klausa Pilih.
- Atribut
Contoh
Contoh berikut menunjukkan cara menggunakan nilai yang disediakan pengguna untuk menghitung nilai dalam data yang dikembalikan. Pengguna dapat memasukkan nilai dalam kotak teks yang menunjukkan jumlah hari pembuatan. Nilai tersebut dibagi dengan nilai dari database yang menunjukkan jumlah hari untuk memproduksi produk. Nilai yang dikembalikan menunjukkan berapa banyak produk yang dapat diproduksi selama jumlah hari yang ditentukan. Input pengguna disertakan dalam perintah Pilih melalui SelectParameters koleksi.
Enter number of manufacturing days:
<asp:TextBox Text="1" ID="TextBox1" runat="server"></asp:TextBox><br />
<asp:Button ID="Button1" runat="server" Text="Refresh" /><br />
<asp:GridView ID="GridView1" runat="server" AllowPaging="True"
AllowSorting="True" AutoGenerateColumns="False" DataSourceID="LinqDataSource1">
<Columns>
<asp:boundfield DataField="Name"
HeaderText="Name"
ReadOnly="True"
SortExpression="Name">
</asp:boundfield>
<asp:boundfield DataField="NumberToManufacture"
HeaderText="Number to Manufacture"
ReadOnly="True"
SortExpression="NumberToManufacture">
</asp:boundfield>
</Columns>
</asp:GridView>
<asp:LinqDataSource
ContextTypeName="ExampleDataContext"
TableName="Products"
Where="DaysToManufacture > 0 "
Select="new (Name, @Days / DaysToManufacture As NumberToManufacture)"
ID="LinqDataSource1"
runat="server">
<SelectParameters>
<asp:ControlParameter
Type="Decimal"
Name="Days"
ControlID="TextBox1"
DefaultValue="1" />
</SelectParameters>
</asp:LinqDataSource>
Enter number of manufacturing days:
<asp:TextBox Text="1" ID="TextBox1" runat="server"></asp:TextBox><br />
<asp:Button ID="Button1" runat="server" Text="Refresh" /><br />
<asp:GridView ID="GridView1" runat="server" AllowPaging="True"
AllowSorting="True" AutoGenerateColumns="False" DataSourceID="LinqDataSource1">
<Columns>
<asp:boundfield DataField="Name"
HeaderText="Name"
ReadOnly="True"
SortExpression="Name">
</asp:boundfield>
<asp:boundfield DataField="NumberToManufacture"
HeaderText="Number to Manufacture"
ReadOnly="True"
SortExpression="NumberToManufacture">
</asp:boundfield>
</Columns>
</asp:GridView>
<asp:LinqDataSource
ContextTypeName="ExampleDataContext"
TableName="Products"
Where="DaysToManufacture > 0 "
Select="new (Name, @Days / DaysToManufacture As NumberToManufacture)"
ID="LinqDataSource1"
runat="server">
<SelectParameters>
<asp:ControlParameter
Type="Decimal"
Name="Days"
ControlID="TextBox1"
DefaultValue="1" />
</SelectParameters>
</asp:LinqDataSource>
Keterangan
Kontrol LinqDataSource menggunakan parameter dalam SelectParameters koleksi untuk membuat klausa Pilih pada durasi. Anda menambahkan parameter ke SelectParameters koleksi saat Anda ingin menggunakan nilai run-time di klausa Pilih. Misalnya, Anda dapat menambahkan parameter ke SelectParameters koleksi untuk mewakili properti di profil pengguna. Anda kemudian dapat menggunakan properti tersebut dan nilai dari sumber data untuk menghitung nilai baru.
Jika Anda tidak perlu mengatur nilai pada durasi dalam klausa Pilih, Anda tidak perlu menggunakan SelectParameters koleksi. Anda dapat menentukan properti untuk diambil di Select properti . Misalnya, untuk mengembalikan FirstName
nilai dan LastName
dari tabel database, atur Select ke "FirstName, LastName" tanpa parameter apa pun.
Untuk mengatur nilai dalam SelectParameters koleksi, Anda menambahkan tempat penampung di Select properti untuk parameter bernama. Di klausa Pilih, awali setiap nama parameter dengan simbol @.
Anda tidak dapat menggunakan parameter dalam SelectParameters koleksi untuk mewakili nama properti. Untuk mengatur Select properti secara dinamis ke nama properti, buat penanganan aktivitas untuk Selecting peristiwa dan sesuaikan Select properti sesuai kebutuhan.