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 网页验证用户输入是否不包含脚本或 HTML 元素。有关详细信息，请参阅脚本侵入概述。

<%@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默认值的对象并将其追加到集合的末尾。方法的此实现分别使用和 value 参数指定的name名称和默认值创建 Parameter 对象，并将其追加到集合中。

另请参阅

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 命令中，该控件提供当前系统时间的值。参数与的 DateTime一起TypeCode添加。

<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强类型对象并将其追加到集合的末尾。方法的此实现分别使用和 nametypevalue 参数指定的名称、类型和值来创建 Parameter 对象，并将其追加到集合中。

另请参阅

Parameter

适用于

通过

ParameterCollection.Add 方法

定义

重载

Add(Parameter)

参数

返回

示例

注解

另请参阅

适用于

Add(String, String)

参数

返回

示例

注解

另请参阅

适用于

Add(String, DbType, String)

参数

返回

注解

适用于

Add(String, TypeCode, String)

参数

返回

示例

注解

另请参阅

适用于

其他资源