.NET Framework 애플리케이션의 데이터베이스에 새 레코드 삽입

TableAdapter 메서드를 사용하는 것은 .NET Framework 프로젝트에서 ADO.NET를 사용하여 데이터베이스에 새 레코드를 삽입하는 경우에 일반적입니다. 애플리케이션과 데이터베이스 간의 통신을 TableAdapter가 사용 가능하도록 합니다. 이는 애플리케이션의 요구 사항에 따라 새 레코드를 데이터베이스에 삽입하기 위한 다양한 방법을 제공합니다. TableAdapter.Update 메서드 또는 TableAdapter DBDirect 메서드(특히 TableAdapter.Insert 메서드) 중 하나를 사용할 수 있습니다.

ADO.NET 및 .NET Framework로 빌드된 애플리케이션의 데이터베이스에 레코드를 삽입하기 위해 VB(Visual Basic) 또는 C#을 사용하는 방법을 이 문서에서 설명합니다. 애플리케이션 구성에서 Entity Framework 6을 사용하는 경우 컨텍스트에 새 엔터티 추가하기, 또는 Entity Framework Core를 사용하는 경우 데이터 추가하기를 참조하세요.

필수 조건

• 사용 가능한 인스턴스가 있어야 TableAdapter 메서드를 사용할 수 있습니다. .NET Framework 응용 프로그램에서 TableAdapters 생성하기 및 구성하기를 참조하여 자세한 내용을 확인하세요.

• .NET 보안: 원하는 테이블에 삽입을 수행할 수 있는 권한 및 연결하려는 데이터베이스에 대한 액세스 권한이 있어야 합니다.

삽입 메서드를 선택하세요

데이터베이스에 레코드를 삽입하는 방법은 애플리케이션 시나리오에 따라 여러 가지가 있습니다. 해당 옵션은 다음의 표에 요약되어 있습니다.

TableAdapter를 사용하여 새 레코드 삽입

응용 프로그램에서 데이터 집합을 사용하여 데이터를 저장하는 경우 데이터 집합에서 원하는 DataTable 레코드에 새 레코드를 추가한 다음 메서드를 호출 TableAdapter.Update 할 수 있습니다. TableAdapter.Update 메서드는 데이터베이스에 DataTable의 모든 변경 내용을 보냅니다. 이 내용은 수정 및 삭제된 레코드를 포함합니다.

TableAdapter.Update 메서드를 통해 새 레코드를 삽입합니다

새 레코드를 데이터베이스에 삽입하기 위해 TableAdapter.Update 메서드를 사용하는 방법을 다음 절차에서 보여 줍니다.

1. 새 DataRow를 만들고 Rows 컬렉션에 추가하여 원하는 DataTable에 새 레코드를 추가합니다.

2. DataTable에 새 행을 추가한 다음, TableAdapter.Update 메서드를 호출합니다. 업데이트할 데이터의 양을 제어하기 위해 다음 매개 변수 값 중 하나를 전달할 수 있습니다.

   • 전체 DataSet
   • DataTable
   • DataRow의 배열
   • 단일 DataRow

   다음 코드에서는 DataTable에 새 레코드를 추가한 다음, TableAdapter.Update 메서드를 호출하여 새 행을 데이터베이스에 저장하는 방법을 보여 줍니다. Northwind 데이터베이스의 Region 테이블을 이 예제에서 사용합니다.

   • C#
   • VB

   // Create a new row.
   NorthwindDataSet.RegionRow newRegionRow;
   newRegionRow = northwindDataSet.Region.NewRegionRow();
   newRegionRow.RegionID = 5;
   newRegionRow.RegionDescription = "NorthWestern";
   
   // Add the row to the Region table
   this.northwindDataSet.Region.Rows.Add(newRegionRow);
   
   // Save the new row to the database
   this.regionTableAdapter.Update(this.northwindDataSet.Region);
   

TableAdapter.Insert 메서드를 통해 새 레코드를 삽입합니다

애플리케이션에서 개체를 사용하여 데이터를 저장하는 경우 TableAdapter.Insert 메서드를 사용하여 데이터베이스에 직접 새 행을 만들 수 있습니다. Insert 메서드는 각 열의 개별 값을 매개 변수로 수락합니다. 메서드를 호출하는 경우, 새 레코드를 데이터베이스에 삽입하기 위해 전달된 매개 변수 값이 사용됩니다.

• TableAdapter의 Insert 메서드를 호출한 다음, 매개 변수로 각 열의 값을 전달합니다.

행을 삽입하기 위해 TableAdapter.Insert 메서드를 사용하는 방법을 다음 절차에서 보여 줍니다. 이 예제에서는 Northwind 데이터베이스의 Region 테이블에 데이터를 삽입합니다.

NorthwindDataSetTableAdapters.RegionTableAdapter regionTableAdapter = 
    new NorthwindDataSetTableAdapters.RegionTableAdapter();

regionTableAdapter.Insert(5, "NorthWestern");

Dim regionTableAdapter As New NorthwindDataSetTableAdapters.RegionTableAdapter

regionTableAdapter.Insert(5, "NorthWestern")

명령 개체를 통해 새 레코드를 삽입합니다

데이터베이스에 직접 새 레코드를 삽입하기 위해 명령 개체를 사용할 수 있습니다.

• 새 명령 개체를 만든 다음, 해당 Connection, CommandType, CommandText 속성을 설정합니다.

레코드를 데이터베이스에 삽입하기 위해 명령 개체를 사용하는 방법을 다음 절차에서 보여 줍니다. 이 예제에서는 데이터를 Northwind 데이터베이스의 Region 테이블에 삽입합니다.

System.Data.SqlClient.SqlConnection sqlConnection1 = 
    new System.Data.SqlClient.SqlConnection("YOUR CONNECTION STRING");

System.Data.SqlClient.SqlCommand cmd = new System.Data.SqlClient.SqlCommand();
cmd.CommandType = System.Data.CommandType.Text;
cmd.CommandText = "INSERT Region (RegionID, RegionDescription) VALUES (5, 'NorthWestern')";
cmd.Connection = sqlConnection1;

sqlConnection1.Open();
cmd.ExecuteNonQuery();
sqlConnection1.Close();

Dim sqlConnection1 As New System.Data.SqlClient.SqlConnection("YOUR CONNECTION STRING")

Dim cmd As New System.Data.SqlClient.SqlCommand
cmd.CommandType = System.Data.CommandType.Text
cmd.CommandText = "INSERT Region (RegionID, RegionDescription) VALUES (5, 'NorthWestern')"
cmd.Connection = sqlConnection1

sqlConnection1.Open()
cmd.ExecuteNonQuery()
sqlConnection1.Close()

관련 콘텐츠

• 데이터를 다시 데이터베이스에 저장
• .NET Framework 응용 프로그램에서 TableAdapter DBDirect 메서드를 사용하여 데이터 저장