ParameterCollection.Add 메서드

정의

네임스페이스:: System.Web.UI.WebControls

어셈블리:: System.Web.dll

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

컬렉션에 Parameter 개체를 추가합니다.

오버로드

Name	Description
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 개체를 사용하여 Microsoft Access 데이터베이스의 정보를 GridView 컨트롤에 표시하는 방법을 보여 줍니다. 개체는 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

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

설명

이 메서드는 데이터베이스 형식을 위한 것입니다. CLR 형식에 Add(String, TypeCode, String) 메서드를 사용합니다.

적용 대상

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 의 개체를 만들고 컬렉션의 끝에 기본값으로 추가합니다. 이 메서드 Parameter 구현에서는 이름, 형식 및 매개 변수로 nametypevalue 지정된 값을 사용하여 개체를 만들고 컬렉션에 추가합니다.

추가 정보

Parameter

적용 대상

피드백

이 페이지가 도움이 되었나요?