ParameterCollection.Add 方法

參考

定義

命名空間:: System.Web.UI.WebControls

組件:: System.Web.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

將 Parameter 物件加入至集合。

多載

Add(Parameter)	將指定的 Parameter 物件附加到集合的結尾。
Add(String, String)	以指定的名稱和預設值建立 Parameter 物件，並將其附加至集合結尾。
Add(String, DbType, String)	使用指定的名稱、資料庫型別及預設值建立 Parameter 物件，並將它加入集合的結尾。
Add(String, TypeCode, String)	以指定的名稱、Parameter 和預設值建立 TypeCode 物件，並將其附加至集合結尾。

Add(Parameter)

將指定的 Parameter 物件附加到集合的結尾。

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，要附加至集合。

傳回

Int32

加入項目的索引值。

範例

下列程式代碼範例示範如何使用 AccessDataSource 控件和 FormParameter 物件，在控件中 GridView 顯示 Microsoft Access 資料庫中的資訊。物件FormParameter會使用 Add(Parameter) 方法新增至SelectParameters集合。

重要

這個範例有一個可接受使用者輸入的文字方塊，這可能會造成安全性威脅。根據預設，ASP.NET Web 網頁會驗證使用者輸入未包含指令碼或 HTML 項目。如需詳細資訊，請參閱 Script Exploits Overview (指令碼攻擊概觀)。

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

備註

Add(Parameter)使用方法，將物件附加Parameter至集合結尾。這個方法的實作會採用 Parameter 參數所指定的物件， param 並將它附加至集合。

另請參閱

適用於

Add(String, String)

以指定的名稱和預設值建立 Parameter 物件，並將其附加至集合結尾。

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

參數

name: String

參數名稱。

value: String

字串，做為參數的預設值。

傳回

Int32

加入項目的索引值。

範例

下列程式代碼範例示範如何使用 Add(String, String) 方法，藉由提供 name 和 value 參數，將新的Parameter物件ParameterCollection加入集合。在此範例中， Parameter 物件會新增至 Access 數據源控件的 Update 命令，該控件系結至控件的值 TextBox 。

重要

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

備註

Add(String, String)使用方法來建立物件，並將預設值附加Parameter至集合結尾。這個方法的實作會Parameter分別使用和 value 參數所name指定的名稱和預設值來建立物件，並將它附加至集合。

另請參閱

Parameter

適用於

Add(String, DbType, String)

使用指定的名稱、資料庫型別及預設值建立 Parameter 物件，並將它加入集合的結尾。

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

參數

name: String

參數名稱。

dbType: DbType

參數的資料庫型別。

value: String

參數的預設值。

傳回

Int32

加入項目的索引值。

備註

這個方法適用於資料庫類型。 Add(String, TypeCode, String)使用 CLR 類型的方法。

適用於

Add(String, TypeCode, String)

以指定的名稱、Parameter 和預設值建立 TypeCode 物件，並將其附加至集合結尾。

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

參數

name: String

參數名稱。

type: TypeCode

參數的類型。

value: String

參數的預設值。

傳回

Int32

加入項目的索引值。

範例

下列程式代碼範例示範如何使用 Add(String, TypeCode, String) 方法，藉由提供name、 value和 type 參數，將新Parameter物件ParameterCollection加入集合。在此範例中， Parameter 物件會新增至 Access 數據源控件的 Update 命令，以提供目前系統時間的值。參數會以 TypeCode 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>

備註

Add(String, TypeCode, String)使用方法來建立強型別Parameter物件，並將預設值附加至集合結尾。這個方法的實作會Parameter使用、 type 和 value 參數所name指定的名稱、類型和值，分別建立物件，並將它附加至集合。

另請參閱

Parameter

適用於

共用方式為

ParameterCollection.Add 方法

定義

多載

Add(Parameter)

參數

傳回

範例

備註

另請參閱

適用於

Add(String, String)

參數

傳回

範例

備註

另請參閱

適用於

Add(String, DbType, String)

參數

傳回

備註

適用於

Add(String, TypeCode, String)

參數

傳回

範例

備註

另請參閱

適用於

其他資源