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 该方法将对象添加到 SelectParameters 集合 Add(Parameter) 中。

Important

此示例有一个接受用户输入的文本框，这是潜在的安全威胁。默认情况下，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)使用该方法创建对象并将其追加Parameter到集合末尾的默认值。此方法的此实现使用分别由Parameter和name参数指定的名称和默认值创建value对象，并将其追加到集合中。

另请参阅

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

另请参阅

Parameter

适用于

反馈

此页面是否有帮助？

ParameterCollection.Add 方法

定义

重载

Add(Parameter)

参数

返回

示例

注解

另请参阅

适用于

Add(String, String)

参数

返回

注解

另请参阅

适用于

Add(String, DbType, String)

参数

返回

注解

适用于

Add(String, TypeCode, String)

参数

返回

注解

另请参阅

适用于