다음을 통해 공유


ParameterCollection.Add 메서드

정의

컬렉션에 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입니다.

반환

추가된 항목의 인덱스 값입니다.

예제

다음 코드 예제에 사용 하는 방법을 보여 줍니다.는 AccessDataSource 컨트롤 및 FormParameter Microsoft Access 데이터베이스에서 정보를 표시 하는 개체는 GridView 제어 합니다. 합니다 FormParameter 개체에 추가 됩니다 합니다 SelectParameters 사용 하 여 컬렉션을 Add(Parameter) 메서드.

중요

이 예제에는 사용자 입력을 허용하는 텍스트 상자가 있으므로 보안상 위험할 수 있습니다. 기본적으로 ASP.NET 웹 페이지는 사용자 입력 내용에 스크립트 또는 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

매개 변수의 기본값으로 사용되는 문자열입니다.

반환

추가된 항목의 인덱스 값입니다.

예제

다음 코드 예제에서는 하는 방법을 Add(String, String) 메서드를 사용 하 여 새 추가할 수 있습니다 Parameter 개체를 ParameterCollection 제공 하 여 컬렉션의 namevalue 매개 변수입니다. 이 예제는 Parameter 개체의 값에 바인딩되는 Access 데이터 소스 컨트롤의 업데이트 명령에 추가 됩니다을 TextBox 컨트롤입니다.

중요

이 예제에는 사용자 입력을 허용하는 텍스트 상자가 있으므로 보안상 위험할 수 있습니다. 기본적으로 ASP.NET 웹 페이지는 사용자 입력 내용에 스크립트 또는 HTML 요소가 포함되어 있지 않은지 확인합니다. 자세한 내용은 Script Exploits Overview를 참조하세요.

<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 에 지정 된 이름 및 기본 값을 사용 하 여 개체를 namevalue 매개 변수 각각 컬렉션에 추가 합니다.

추가 정보

적용 대상

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

매개 변수에 대한 기본값입니다.

반환

추가된 항목의 인덱스 값입니다.

설명

이 메서드는 데이터베이스 형식입니다. 사용 된 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

매개 변수에 대한 기본값입니다.

반환

추가된 항목의 인덱스 값입니다.

예제

다음 코드 예제에서는 하는 방법을 Add(String, TypeCode, String) 메서드를 사용 하 여 새 추가할 수 있습니다 Parameter 개체를 ParameterCollection 제공 하 여 컬렉션을 namevalue, 및 type 매개 변수입니다. 이 예제는 Parameter 개체의 현재 시스템 시간 값을 제공 하는 Access 데이터 소스 컨트롤의 업데이트 명령에 추가 됩니다. 매개 변수는 사용 하 여 추가 합니다 TypeCodeDateTime합니다.

<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 이름, 형식 및 지정 된 값을 사용 하 여 개체를 nametypevalue 매개 변수 각각 컬렉션에 추가 합니다.

추가 정보

적용 대상