Parameter.Name Properti

Referensi

Definisi

Ruang nama:: System.Web.UI.WebControls

Rakitan:: System.Web.dll

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, set

Public Property Name As String

Nilai Properti

String

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 di 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 diharuskan 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 akan dipanggil.

Berlaku untuk

Lihat juga

Type

Bagikan melalui