FormParameter 클래스

정의

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

어셈블리:: System.Web.dll

중요

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

HTTP 요청 Form 필드의 값을 매개 변수 개체에 바인딩합니다.

public ref class FormParameter : System::Web::UI::WebControls::Parameter

public class FormParameter : System.Web.UI.WebControls.Parameter

type FormParameter = class
    inherit Parameter

Public Class FormParameter
Inherits Parameter

상속: Object

Parameter
FormParameter

예제

다음 코드 예제에서는 컨트롤 및 간단한 ASP.NET 웹 페이지를 사용 하 여 SqlDataSource 데이터베이스에 데이터를 삽입 하는 방법을 보여 줍니다. 데이터 테이블의 현재 데이터가 컨트롤에 DropDownList 표시됩니다. 컨트롤에 TextBox 값을 입력하고 단추를 클릭하여 새 레코드를 추가할 수 있습니다. 단추를 클릭하면 지정된 값이 데이터베이스에 삽입되고 DropDownList 새로 고쳐집니다.

중요합니다

이 예제에는 잠재적인 보안 위협인 사용자 입력을 허용하는 텍스트 상자가 있습니다. 기본적으로 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">
private void InsertShipper (object source, EventArgs e) {
  SqlDataSource1.Insert();
}
</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:dropdownlist
        id="DropDownList1"
        runat="server"
        datasourceid="SqlDataSource1"
        datatextfield="CompanyName"
        datavaluefield="ShipperID" />

<!-- Security Note: The SqlDataSource uses a FormParameter,
     Security Note: which does not perform validation of input from the client.
     Security Note: To validate the value of the FormParameter, handle the Inserting event. -->

      <asp:sqldatasource
        id="SqlDataSource1"
        runat="server"
        connectionstring="<%$ ConnectionStrings:MyNorthwind %>"
        selectcommand="SELECT CompanyName,ShipperID FROM Shippers"
        insertcommand="INSERT INTO Shippers (CompanyName,Phone) VALUES (@CoName,@Phone)">
          <insertparameters>
            <asp:formparameter name="CoName" formfield="CompanyNameBox" />
            <asp:formparameter name="Phone"  formfield="PhoneBox" />
          </insertparameters>
      </asp:sqldatasource>

      <br /><asp:textbox
           id="CompanyNameBox"
           runat="server" />

      <asp:RequiredFieldValidator
        id="RequiredFieldValidator1"
        runat="server"
        ControlToValidate="CompanyNameBox"
        Display="Static"
        ErrorMessage="Please enter a company name." />

      <br /><asp:textbox
           id="PhoneBox"
           runat="server" />

      <asp:RequiredFieldValidator
        id="RequiredFieldValidator2"
        runat="server"
        ControlToValidate="PhoneBox"
        Display="Static"
        ErrorMessage="Please enter a phone number." />

      <br /><asp:button
           id="Button1"
           runat="server"
           text="Insert New Shipper"
           onclick="InsertShipper" />

    </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 InsertShipper (ByVal Source As Object, ByVal e As EventArgs)
  SqlDataSource1.Insert()
End Sub ' InsertShipper
</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:dropdownlist
        id="DropDownList1"
        runat="server"
        datasourceid="SqlDataSource1"
        datatextfield="CompanyName"
        datavaluefield="ShipperID" />

<!-- Security Note: The SqlDataSource uses a FormParameter,
     Security Note: which does not perform validation of input from the client.
     Security Note: To validate the value of the FormParameter, handle the Inserting event. -->

      <asp:sqldatasource
        id="SqlDataSource1"
        runat="server"
        connectionstring="<%$ ConnectionStrings:MyNorthwind %>"
        selectcommand="SELECT CompanyName,ShipperID FROM Shippers"
        insertcommand="INSERT INTO Shippers (CompanyName,Phone) VALUES (@CoName,@Phone)">
          <insertparameters>
            <asp:formparameter name="CoName" formfield="CompanyNameBox" />
            <asp:formparameter name="Phone"  formfield="PhoneBox" />
          </insertparameters>
      </asp:sqldatasource>

      <br /><asp:textbox
           id="CompanyNameBox"
           runat="server" />

      <asp:RequiredFieldValidator
        id="RequiredFieldValidator1"
        runat="server"
        ControlToValidate="CompanyNameBox"
        Display="Static"
        ErrorMessage="Please enter a company name." />

      <br /><asp:textbox
           id="PhoneBox"
           runat="server" />

      <asp:RequiredFieldValidator
        id="RequiredFieldValidator2"
        runat="server"
        ControlToValidate="PhoneBox"
        Display="Static"
        ErrorMessage="Please enter a phone number." />

      <br /><asp:button
           id="Button1"
           runat="server"
           text="Insert New Shipper"
           onclick="InsertShipper" />

    </form>
  </body>
</html>

설명

클래스를 FormParameter 사용하여 컬렉션의 양식 변수 값을 매개 변수가 있는 Form 쿼리 또는 명령에 사용되는 매개 변수에 바인딩할 수 있습니다. 매개 변수에 데이터를 바인딩하는 컨트롤은 지정된 경우 예외를 FormParameter throw할 수 있지만 해당 양식 변수는 전달되지 않습니다. 양식 변수가 해당 값 없이 전달되는 경우에도 데이터가 표시되지 않을 수 있습니다. DefaultValue 적절한 경우 이러한 상황을 방지하도록 설정합니다.

클래스는 FormParameter 클래스에서 Parameter 상속된 속성 외에도 바인딩할 양식 변수의 이름을 식별하는 속성을 제공합니다FormField.

중요합니다

FormParameter 양식 요소에서 전달된 값의 유효성을 검사하지 않으며 원시 값을 사용합니다. 대부분의 경우 사용 중인 데이터 원본 컨트롤에 의해 노출되는 이벤트 또는 이벤트와 같은 DeletingInsertingUpdatingSelecting이벤트를 처리하여 데이터 원본 컨트롤에서 사용하기 전의 값 FormParameter 의 유효성을 검사할 수 있습니다. 매개 변수 값이 유효성 검사 테스트를 통과하지 못하면 연결된 CancelEventArgs 클래스의 속성을 .로 설정 Cancel 하여 데이터 작업을 취소할 true수 있습니다.

생성자

Name	Description
FormParameter()	클래스의 명명되지 않은 새 인스턴스를 초기화합니다 FormParameter .
FormParameter(FormParameter)	매개 변수로 지정된 인스턴스의 FormParameter 값을 사용하여 클래스의 새 인스턴스를 `original` 초기화합니다.
FormParameter(String, DbType, String)	지정된 문자열을 사용하여 바인딩할 폼 변수 필드를 식별하여 클래스의 FormParameter 새 인스턴스를 초기화합니다.
FormParameter(String, String)	지정된 문자열을 사용하여 바인딩할 폼 변수 필드를 식별하여 클래스의 FormParameter 명명된 새 인스턴스를 초기화합니다.
FormParameter(String, TypeCode, String)	지정된 문자열을 사용하여 바인딩할 양식 변수를 식별하여 클래스의 명명되고 강력한 형식의 FormParameter 새 인스턴스를 초기화합니다.

속성

Name	Description
ConvertEmptyStringToNull	개체가 바인딩된 값을 변환할지 `null`Empty여부를 나타내는 값을 Parameter 가져오거나 설정합니다. (다음에서 상속됨 Parameter)
DbType	매개 변수의 데이터베이스 형식을 가져오거나 설정합니다. (다음에서 상속됨 Parameter)
DefaultValue	메서드가 호출될 때 매개 변수가 초기화되지 않을 바인딩된 값인 경우 매개 변수의 기본값을 Evaluate(HttpContext, Control) 지정합니다. (다음에서 상속됨 Parameter)
Direction	개체가 컨트롤에 Parameter 값을 바인딩하는 데 사용되는지 또는 컨트롤을 사용하여 값을 변경할 수 있는지 여부를 나타냅니다. (다음에서 상속됨 Parameter)
FormField	매개 변수가 바인딩하는 양식 변수의 이름을 가져오거나 설정합니다.
IsTrackingViewState	개체가 뷰 상태에 대한 변경 내용을 저장하고 있는지 여부를 Parameter 나타내는 값을 가져옵니다. (다음에서 상속됨 Parameter)
Name	매개 변수의 이름을 가져오거나 설정합니다. (다음에서 상속됨 Parameter)
Size	매개 변수의 크기를 가져오거나 설정합니다. (다음에서 상속됨 Parameter)
Type	매개 변수의 형식을 가져오거나 설정합니다. (다음에서 상속됨 Parameter)
ValidateInput	매개 변수의 클라이언트 입력 유효성이 검사되는지 여부를 나타내는 값을 가져오거나 설정합니다.
ViewState	동일한 페이지에 대한 여러 요청에서 개체의 Parameter 뷰 상태를 저장하고 복원할 수 있는 상태 정보 사전을 가져옵니다. (다음에서 상속됨 Parameter)

메서드

Name	Description
Clone()	현재 FormParameter 인스턴스의 중복을 반환합니다.
Equals(Object)	지정된 개체가 현재 개체와 같은지 여부를 확인합니다. (다음에서 상속됨 Object)
Evaluate(HttpContext, Control)	개체의 FormParameter 값을 업데이트하고 반환합니다.
GetDatabaseType()	현재 Parameter 인스턴스의 DbType CLR 형식과 동일한 값을 가져옵니다. (다음에서 상속됨 Parameter)
GetHashCode()	기본 해시 함수로 사용됩니다. (다음에서 상속됨 Object)
GetType()	현재 인스턴스의 Type 가져옵니다. (다음에서 상속됨 Object)
LoadViewState(Object)	데이터 원본 뷰의 이전에 저장된 뷰 상태를 복원합니다. (다음에서 상속됨 Parameter)
MemberwiseClone()	현재 Object단순 복사본을 만듭니다. (다음에서 상속됨 Object)
OnParameterChanged()	개체를 OnParametersChanged(EventArgs) 포함하는 컬렉션의 ParameterCollection 메서드를 Parameter 호출합니다. (다음에서 상속됨 Parameter)
SaveViewState()	페이지가 서버에 다시 게시된 이후 개체의 뷰 상태에 대한 변경 내용을 Parameter 저장합니다. (다음에서 상속됨 Parameter)
SetDirty()	개체의 Parameter 상태가 뷰 상태에 기록되도록 개체를 표시합니다. (다음에서 상속됨 Parameter)
ToString()	이 인스턴스의 값을 해당하는 문자열 표현으로 변환합니다. (다음에서 상속됨 Parameter)
TrackViewState()	개체가 Parameter 컨트롤의 ViewState 개체에 저장되고 동일한 페이지에 대한 요청 간에 유지될 수 있도록 개체가 뷰 상태에 대한 변경 내용을 추적하도록 합니다. (다음에서 상속됨 Parameter)

명시적 인터페이스 구현

Name	Description
ICloneable.Clone()	현재 Parameter 인스턴스의 중복을 반환합니다. (다음에서 상속됨 Parameter)
IStateManager.IsTrackingViewState	개체가 뷰 상태에 대한 변경 내용을 저장하고 있는지 여부를 Parameter 나타내는 값을 가져옵니다. (다음에서 상속됨 Parameter)
IStateManager.LoadViewState(Object)	데이터 원본 뷰의 이전에 저장된 뷰 상태를 복원합니다. (다음에서 상속됨 Parameter)
IStateManager.SaveViewState()	페이지가 서버에 다시 게시된 이후 개체의 뷰 상태에 대한 변경 내용을 Parameter 저장합니다. (다음에서 상속됨 Parameter)
IStateManager.TrackViewState()	개체가 Parameter 컨트롤의 ViewState 개체에 저장되고 동일한 페이지에 대한 요청 간에 유지될 수 있도록 개체가 뷰 상태에 대한 변경 내용을 추적하도록 합니다. (다음에서 상속됨 Parameter)

적용 대상

추가 정보

피드백

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

다음을 통해 공유

FormParameter 클래스

정의

예제

설명

생성자

속성

메서드

명시적 인터페이스 구현

적용 대상

추가 정보

피드백