Parameter.Name 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 atau mengatur nama parameter.
public:
property System::String ^ Name { System::String ^ get(); void set(System::String ^ value); };public string Name { get; set; }member this.Name : string with get, setPublic Property Name As StringNilai Properti
Nama parameter. Nilai defaultnya adalah Empty.
Contoh
Contoh kode berikut menunjukkan cara menampilkan data yang ObjectDataSource difilter menggunakan kontrol untuk mengambil data dari objek bisnis tingkat menengah dan GridView kontrol untuk menampilkan hasilnya. Contoh kode terdiri dari TextBox kontrol, GridView kontrol, ObjectDataSource kontrol, dan tombol Kirim. Secara default, TextBox kontrol diisi dengan nama salah Northwind satu karyawan.
GridView Kontrol menampilkan informasi tentang karyawan yang diidentifikasi dengan nama dalam TextBox kontrol. Untuk mengambil data pada karyawan lain, masukkan nama lengkap karyawan dalam TextBox kontrol dan klik tombol .
Properti FilterExpression menentukan ekspresi yang digunakan untuk memfilter data yang diambil oleh SelectMethod properti . Ini menggunakan tempat penampung parameter yang dievaluasi ke parameter yang terkandung dalam FilterParameters koleksi. Dalam contoh ini, tempat penampung parameter dibatasi oleh tanda kutip tunggal karena jenis parameter adalah jenis string yang mungkin berisi spasi. Jika jenis parameter adalah jenis numerik atau tanggal, tanda kutip pembatas tidak diperlukan.
Contoh kode ini adalah bagian dari contoh yang lebih besar yang disediakan untuk FilterExpression properti ObjectDataSource kelas .
<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.CS" Assembly="Samples.AspNet.CS" %>
<%@ Page language="c#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
protected void ObjectDataSource1_Filtering(object sender, ObjectDataSourceFilteringEventArgs e)
{
if (Textbox1.Text == "")
{
e.ParameterValues.Clear();
e.ParameterValues.Add("FullName", "Nancy Davolio");
}
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>ObjectDataSource - C# Example</title>
</head>
<body>
<form id="Form1" method="post" runat="server">
<p>Show all users with the following name.</p>
<asp:textbox id="Textbox1" runat="server" text="Nancy Davolio" />
<asp:gridview
id="GridView1"
runat="server"
datasourceid="ObjectDataSource1"
autogeneratecolumns="False">
<columns>
<asp:boundfield headertext="ID" datafield="EmpID" />
<asp:boundfield headertext="Name" datafield="FullName" />
<asp:boundfield headertext="Street Address" datafield="Address" />
</columns>
</asp:gridview>
<!-- Security Note: The ObjectDataSource uses a FormParameter,
Security Note: which does not perform validation of input from the client. -->
<asp:objectdatasource
id="ObjectDataSource1"
runat="server"
selectmethod="GetAllEmployeesAsDataSet"
typename="Samples.AspNet.CS.EmployeeLogic"
filterexpression="FullName='{0}'" OnFiltering="ObjectDataSource1_Filtering">
<filterparameters>
<asp:formparameter name="FullName" formfield="Textbox1" defaultvalue="Nancy Davolio" />
</filterparameters>
</asp:objectdatasource>
<p><asp:button id="Button1" runat="server" text="Search" /></p>
</form>
</body>
</html>
<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.VB" Assembly="Samples.AspNet.VB" %>
<%@ Page language="vb" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Protected Sub ObjectDataSource1_Filtering(ByVal sender As Object, ByVal e As System.Web.UI.WebControls.ObjectDataSourceFilteringEventArgs)
If Textbox1.Text = "" Then
e.ParameterValues.Clear()
e.ParameterValues.Add("FullName", "Nancy Davolio")
End If
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
<title>ObjectDataSource - VB Example</title>
</head>
<body>
<form id="Form1" method="post" runat="server">
<p>Show all users with the following name.</p>
<asp:textbox id="Textbox1" runat="server" text="Nancy Davolio" />
<asp:gridview
id="GridView1"
runat="server"
datasourceid="ObjectDataSource1"
autogeneratecolumns="False">
<columns>
<asp:boundfield headertext="ID" datafield="EmpID" />
<asp:boundfield headertext="Name" datafield="FullName" />
<asp:boundfield headertext="Street Address" datafield="Address" />
</columns>
</asp:gridview>
<!-- Security Note: The ObjectDataSource uses a FormParameter,
Security Note: which does not perform validation of input from the client. -->
<asp:objectdatasource
id="ObjectDataSource1"
runat="server"
selectmethod="GetAllEmployeesAsDataSet"
typename="Samples.AspNet.VB.EmployeeLogic"
filterexpression="FullName='{0}'" OnFiltering="ObjectDataSource1_Filtering">
<filterparameters>
<asp:formparameter name="FullName" formfield="Textbox1" defaultvalue="Nancy Davolio" />
</filterparameters>
</asp:objectdatasource>
<p><asp:button id="Button1" runat="server" text="Search" /></p>
</form>
</body>
</html>
Keterangan
Parameter objek tidak diperlukan untuk memiliki nama; namun, kontrol sumber data mungkin menggunakan nama parameter untuk mencocokkan Parameter objek dalam koleksi dengan parameter dalam kueri SQL atau tanda tangan metode bisnis. Misalnya, SqlDataSource kontrol dapat menggunakan nama Parameter objek untuk mencocokkan tempat penampung dalam kueri SQL berparameter. Demikian pula, SqlDataSource kontrol dapat menggunakan nama Parameter objek dalam FilterParameters koleksi untuk mencocokkan tempat penampung di FilterExpression properti . Dalam beberapa kasus, nama tidak digunakan dan urutan di mana Parameter objek ditambahkan ke ParameterCollection koleksi lebih penting. Untuk informasi selengkapnya, lihat Menggunakan Parameter dengan Kontrol SqlDataSource dan Menggunakan Parameter dengan Kontrol ObjectDataSource.
Jika nama parameter diubah, OnParameterChanged metode dipanggil.
