ParameterCollection.Add Metode

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.

Parameter Menambahkan objek ke koleksi.

Overload

Add(Parameter)	Menambahkan objek yang ditentukan Parameter ke akhir koleksi.
Add(String, String)	Parameter Membuat objek dengan nama dan nilai default yang ditentukan, dan menambahkannya ke akhir koleksi.
Add(String, DbType, String)	Parameter Membuat objek dengan nama, jenis database, dan nilai default yang ditentukan, dan menambahkannya ke akhir koleksi.
Add(String, TypeCode, String)	Parameter Membuat objek dengan nama yang ditentukan, TypeCode, dan nilai default, dan menambahkannya ke akhir koleksi.

Add(Parameter)

Menambahkan objek yang ditentukan Parameter ke akhir koleksi.

public:
 int Add(System::Web::UI::WebControls::Parameter ^ parameter);

public int Add (System.Web.UI.WebControls.Parameter parameter);

member this.Add : System.Web.UI.WebControls.Parameter -> int

Public Function Add (parameter As Parameter) As Integer

Parameter

parameter: Parameter

Parameter untuk menambahkan ke koleksi.

Mengembalikan

Int32

Nilai indeks item yang ditambahkan.

Contoh

Contoh kode berikut menunjukkan cara menggunakan AccessDataSource kontrol dan FormParameter objek untuk menampilkan informasi dari database Microsoft Access dalam GridView kontrol. Objek FormParameter ditambahkan ke SelectParameters koleksi menggunakan Add(Parameter) metode .

Penting

Contoh ini memiliki kotak teks yang menerima input pengguna, yang merupakan potensi ancaman keamanan. Secara default, ASP.NET halaman Web memvalidasi bahwa input pengguna tidak menyertakan elemen skrip atau HTML. Untuk informasi selengkapnya, lihat Gambaran Umum Eksploitasi Skrip.

<%@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">

void Page_Load(Object sender, EventArgs e){

  // You can add a FormParameter to the AccessDataSource control's
  // SelectParameters collection programmatically.
  AccessDataSource1.SelectParameters.Clear();

  // Security Note: The AccessDataSource uses a FormParameter,
  // Security Note: which does not perform validation of input from the client.
  // Security Note: To validate the value of the FormParameter,
  // Security Note: handle the Selecting event.

  FormParameter formParam = new FormParameter("lastname","LastNameBox");
  formParam.Type=TypeCode.String;
  AccessDataSource1.SelectParameters.Add(formParam);
}

</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <asp:accessdatasource
          id="AccessDataSource1"
          runat="server"
          datasourcemode="DataSet"
          datafile="Northwind.mdb"
          selectcommand="SELECT OrderID,CustomerID,OrderDate,RequiredDate,ShippedDate
                         FROM Orders WHERE EmployeeID =
                         (SELECT EmployeeID FROM Employees WHERE LastName = @lastname)">
      </asp:accessdatasource>

      <br />Enter the name "Davolio" or "King" in the text box and click the button.

      <br />
      <asp:textbox
        id="LastNameBox"
        runat="server" />

      <br />
      <asp:button
        id="Button1"
        runat="server"
        text="Get Records" />

      <br />
      <asp:gridview
          id="GridView1"
          runat="server"
          allowsorting="True"
          datasourceid="AccessDataSource1">
      </asp:gridview>

    </form>
  </body>
</html>

<%@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">

Private Sub Page_Load(sender As Object, e As EventArgs)

  ' You can add a FormParameter to the AccessDataSource control's
  ' SelectParameters collection programmatically.
  AccessDataSource1.SelectParameters.Clear()

  ' Security Note: The AccessDataSource uses a FormParameter,
  ' Security Note: which does not perform validation of input from the client.
  ' Security Note: To validate the value of the FormParameter,
  ' Security Note: handle the Selecting event.

  Dim formParam As New FormParameter("lastname","LastNameBox")
  formParam.Type=TypeCode.String
  AccessDataSource1.SelectParameters.Add(formParam)
End Sub ' Page_Load

</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <asp:accessdatasource
          id="AccessDataSource1"
          runat="server"
          datasourcemode="DataSet"
          datafile="Northwind.mdb"
          selectcommand="SELECT OrderID,CustomerID,OrderDate,RequiredDate,ShippedDate
                         FROM Orders WHERE EmployeeID =
                         (SELECT EmployeeID FROM Employees WHERE LastName = @lastname)">
      </asp:accessdatasource>

      <br />Enter the name "Davolio" or "King" in the text box and click the button.

      <br />
      <asp:textbox
        id="LastNameBox"
        runat="server" />

      <br />
      <asp:button
        id="Button1"
        runat="server"
        text="Get Records" />

      <br />
      <asp:gridview
          id="GridView1"
          runat="server"
          allowsorting="True"
          datasourceid="AccessDataSource1">
      </asp:gridview>

    </form>
  </body>
</html>

Keterangan

Add(Parameter) Gunakan metode untuk menambahkan Parameter objek ke akhir koleksi. Implementasi metode ini mengambil Parameter objek yang ditentukan oleh param parameter dan menambahkannya ke koleksi.

Lihat juga

Berlaku untuk

Add(String, String)

Parameter Membuat objek dengan nama dan nilai default yang ditentukan, dan menambahkannya ke akhir koleksi.

public:
 int Add(System::String ^ name, System::String ^ value);

public int Add (string name, string value);

member this.Add : string * string -> int

Public Function Add (name As String, value As String) As Integer

Parameter

name: String

Nama parameter.

value: String

String yang berfungsi sebagai nilai default untuk parameter .

Mengembalikan

Int32

Nilai indeks item yang ditambahkan.

Contoh

Contoh kode berikut menunjukkan bagaimana Add(String, String) metode dapat digunakan untuk menambahkan objek baru Parameter ke ParameterCollection koleksi dengan menyediakan name parameter dan value . Dalam contoh ini, Parameter objek ditambahkan ke perintah Perbarui kontrol sumber data Access yang terikat ke nilai TextBox kontrol.

Penting

<script runat="server">
private void UpdateRecords(Object source, EventArgs e)
{
  CheckBox cb;
  foreach(GridViewRow row in this.GridView1.Rows) {
    cb = (CheckBox) row.Cells[0].Controls[1];
    if(cb.Checked) {
      string oid = (string) row.Cells[1].Text;
      MyAccessDataSource.UpdateParameters.Add("date", TypeCode.DateTime, DateTime.Now.ToString());
      MyAccessDataSource.UpdateParameters.Add("orderid", oid);
      MyAccessDataSource.Update();
      MyAccessDataSource.UpdateParameters.Clear();
    }
  }
}
</script>

<script runat="server">
Private Sub UpdateRecords(source As Object, e As EventArgs)

  Dim cb As CheckBox
  Dim row As GridViewRow

  For Each row In GridView1.Rows

    cb = CType(row.Cells(0).Controls(1), CheckBox)
    If cb.Checked Then

      Dim oid As String
      oid = CType(row.Cells(1).Text, String)

      MyAccessDataSource.UpdateParameters.Add("date", TypeCode.DateTime, DateTime.Now.ToString())

      MyAccessDataSource.UpdateParameters.Add("orderid", oid)

      MyAccessDataSource.Update()
      MyAccessDataSource.UpdateParameters.Clear()
    End If
  Next
End Sub ' UpdateRecords
</script>

Keterangan

Add(String, String) Gunakan metode untuk membuat dan menambahkan Parameter objek dengan nilai default ke akhir koleksi. Implementasi metode ini membuat Parameter objek menggunakan nama dan nilai default yang ditentukan oleh name parameter dan value , masing-masing, dan menambahkannya ke koleksi.

Lihat juga

Parameter

Berlaku untuk

Add(String, DbType, String)

Parameter Membuat objek dengan nama, jenis database, dan nilai default yang ditentukan, dan menambahkannya ke akhir koleksi.

public:
 int Add(System::String ^ name, System::Data::DbType dbType, System::String ^ value);

public int Add (string name, System.Data.DbType dbType, string value);

member this.Add : string * System.Data.DbType * string -> int

Public Function Add (name As String, dbType As DbType, value As String) As Integer

Parameter

name: String

Nama parameter.

dbType: DbType

Jenis database parameter.

value: String

Nilai default untuk parameter.

Mengembalikan

Int32

Nilai indeks item yang ditambahkan.

Keterangan

Metode ini untuk jenis database. Add(String, TypeCode, String) Gunakan metode untuk jenis CLR.

Berlaku untuk

Add(String, TypeCode, String)

Parameter Membuat objek dengan nama yang ditentukan, TypeCode, dan nilai default, dan menambahkannya ke akhir koleksi.

public:
 int Add(System::String ^ name, TypeCode type, System::String ^ value);

public int Add (string name, TypeCode type, string value);

member this.Add : string * TypeCode * string -> int

Public Function Add (name As String, type As TypeCode, value As String) As Integer

Parameter

name: String

Nama parameter.

type: TypeCode

Jenis parameter.

value: String

Nilai default untuk parameter.

Mengembalikan

Int32

Nilai indeks item yang ditambahkan.

Contoh

Contoh kode berikut menunjukkan bagaimana Add(String, TypeCode, String) metode dapat digunakan untuk menambahkan objek baru Parameter ke ParameterCollection koleksi dengan menyediakan nameparameter , value, dan type . Dalam contoh ini, Parameter objek ditambahkan ke perintah Perbarui kontrol sumber data Access yang menyediakan nilai waktu sistem saat ini. Parameter ditambahkan dengan TypeCode dari DateTime.

<script runat="server">
private void UpdateRecords(Object source, EventArgs e)
{
  CheckBox cb;
  foreach(GridViewRow row in this.GridView1.Rows) {
    cb = (CheckBox) row.Cells[0].Controls[1];
    if(cb.Checked) {
      string oid = (string) row.Cells[1].Text;
      MyAccessDataSource.UpdateParameters.Add("date", TypeCode.DateTime, DateTime.Now.ToString());
      MyAccessDataSource.UpdateParameters.Add("orderid", oid);
      MyAccessDataSource.Update();
      MyAccessDataSource.UpdateParameters.Clear();
    }
  }
}
</script>

<script runat="server">
Private Sub UpdateRecords(source As Object, e As EventArgs)

  Dim cb As CheckBox
  Dim row As GridViewRow

  For Each row In GridView1.Rows

    cb = CType(row.Cells(0).Controls(1), CheckBox)
    If cb.Checked Then

      Dim oid As String
      oid = CType(row.Cells(1).Text, String)

      MyAccessDataSource.UpdateParameters.Add("date", TypeCode.DateTime, DateTime.Now.ToString())

      MyAccessDataSource.UpdateParameters.Add("orderid", oid)

      MyAccessDataSource.Update()
      MyAccessDataSource.UpdateParameters.Clear()
    End If
  Next
End Sub ' UpdateRecords
</script>

Keterangan

Add(String, TypeCode, String) Gunakan metode untuk membuat dan menambahkan objek yang ditik Parameter dengan kuat dengan nilai default ke akhir koleksi. Implementasi metode ini membuat Parameter objek menggunakan nama, jenis, dan nilai yang ditentukan oleh nameparameter , dan typevalue , masing-masing, dan menambahkannya ke koleksi.

Lihat juga

Parameter

Berlaku untuk

Bagikan melalui

ParameterCollection.Add Metode

Definisi

Overload

Add(Parameter)

Parameter

Mengembalikan

Contoh

Keterangan

Lihat juga

Berlaku untuk

Add(String, String)

Parameter

Mengembalikan

Contoh

Keterangan

Lihat juga

Berlaku untuk

Add(String, DbType, String)

Parameter

Mengembalikan

Keterangan

Berlaku untuk

Add(String, TypeCode, String)

Parameter

Mengembalikan

Contoh

Keterangan

Lihat juga

Berlaku untuk

Saran dan Komentar

Sumber Daya Tambahan: