Insert 메서드
이 문서는 기계 번역을 이용하여 번역되었습니다. 문서를 영문으로 보려면 영문 확인란을 선택하세요. 마우스 포인터를 텍스트 위로 이동시켜 팝업 창에서 영문 텍스트를 표시할 수도 있습니다.
번역
영문

SqlDataSource.Insert 메서드 ()

 

InsertCommand SQL 문자열과 InsertParameters 컬렉션에 있는 매개 변수를 사용하여 삽입 작업을 수행합니다.

네임스페이스:   System.Web.UI.WebControls
어셈블리:  System.Web.dll의 System.Web

public int Insert()

반환 값

Type: System.Int32

내부 데이터베이스로 삽입되는 행 수를 나타내는 값입니다.

Exception Condition
InvalidOperationException

SqlDataSource가 내부 데이터 소스와 연결될 수 없는 경우

삽입 작업을 수행하기 전에 OnInserting 메서드가 호출되어 Inserting 이벤트가 발생합니다.이 이벤트를 처리하여 매개 변수의 값을 확인하고 Insert 작업 이전에 모든 전처리를 수행할 수 있습니다.삽입 작업을 수행하기 위해 SqlDataSourceView 개체는 InsertCommand 텍스트 및 연결된 InsertParameters 속성을 사용하여 DbCommand 개체를 만든 다음 내부 데이터베이스에 대해 DbCommand 개체를 실행합니다.

작업이 완료되면 OnInserted 메서드가 호출되면서 Inserted 이벤트가 발생합니다.이 이벤트를 처리하여 모든 반환 값과 오류 코드를 검사한 다음 후처리를 수행할 수 있습니다.

Insert 메서드를 사용하면 Insert 메서드에 프로그래밍 방식으로 액세스할 수 있습니다. SqlDataSource 컨트롤이 데이터 바인딩된 컨트롤에 연결된 경우 데이터 바인딩된 컨트롤이 자동으로 Insert 메서드를 호출합니다.

SqlDataSource 컨트롤과 연결된 SqlDataSourceView 개체의 Insert 메서드가 Insert 메서드를 대리합니다.

System_CAPS_security 보안 참고

값은 유효성 검사 없이 매개 변수에 삽입되므로 보안상 위험할 수 있습니다.쿼리를 실행하기 전에 매개 변수 값의 유효성을 검사하려면 Filtering 이벤트를 사용합니다.자세한 내용은 Script Exploits Overview을 참조하십시오.

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

System_CAPS_security 보안 참고

이 예제에는 사용자 입력을 허용하는 텍스트 상자가 있고 값이 유효성 검사 없이 매개 변수에 삽입되므로 보안상 위험할 수 있습니다.쿼리를 실행하기 전에 매개 변수 값의 유효성을 검사하려면 Inserting 이벤트를 사용합니다.자세한 내용은 Script Exploits Overview을 참조하십시오.

System_CAPS_note참고

이 예는 데이터 액세스에 선언적 구문을 사용하는 방법을 보여 줍니다.태그 대신 코드를 사용하여 데이터에 액세스하는 방법에 대한 자세한 내용은 Accessing Data in Visual Studio를 참조하십시오.

<%@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>

.NET Framework
2.0 이후에 사용 가능
맨 위로 이동
표시:
© 2016 Microsoft