다음을 통해 공유

.NET Framework 애플리케이션에서 TableAdapter DBDirect 메서드를 사용하여 데이터 저장

비고

클래스 및 관련 클래스는 DataSet 2000년대 초반의 레거시 .NET Framework 기술로, 애플리케이션이 데이터베이스와 연결이 끊긴 동안 애플리케이션이 메모리의 데이터로 작업할 수 있도록 합니다. 이 기술은 사용자가 데이터를 수정하고 변경 내용을 데이터베이스에 다시 유지할 수 있도록 하는 앱에 특히 유용합니다. 데이터 세트는 입증된 성공적인 기술이지만 새 .NET 애플리케이션에 권장되는 방법은 Entity Framework Core를 사용하는 것입니다. Entity Framework는 테이블 형식 데이터를 개체 모델로 사용하는 보다 자연스러운 방법을 제공하며 더 간단한 프로그래밍 인터페이스를 제공합니다.

이 자습서에서는 TableAdapter의 DBDirect 메서드를 사용하여 데이터베이스에 대해 직접 SQL 문을 실행하기 위한 자세한 지침을 제공합니다. TableAdapter의 DBDirect 메서드는 데이터베이스 업데이트를 세부적으로 제어합니다. 애플리케이션에서 필요에 따라 개별 Insert, Update, Delete 메서드를 호출하여 특정 SQL 문과 저장 프로시저를 실행하는 데 사용할 수 있습니다. 이는 한 번의 호출로 UPDATE, INSERT, DELETE 문을 수행하는 오버로드된 Update 메서드와 대조됩니다.

이 자습서에서는 다음을 수행하는 방법을 알아봅니다.

  • 데이터 원본 구성 마법사를 사용하여 데이터 세트를 만들고 구성합니다.

  • 데이터 원본 창에서 항목을 끌 때 폼에서 만들 컨트롤을 선택합니다. 자세한 내용은 데이터 원본 창에서 끌 때 만들 컨트롤 설정을 참조하세요.

  • 데이터 원본 창에서 폼으로 항목을 끌어 데이터 바인딩된 폼을 만듭니다.

  • 데이터베이스에 직접 액세스하고 삽입, 업데이트 및 삭제를 수행하는 메서드를 추가합니다.

필수 조건

이 자습서의 단계는 .NET Framework Windows Forms 애플리케이션에서 작동합니다.

이 자습서에서는 SQL Server Express LocalDB 및 Northwind 샘플 데이터베이스를 사용합니다.

  1. SQL Server Express LocalDB가 없는 경우 SQL Server Express 다운로드 페이지 또는 Visual Studio 설치 관리자를 통해 설치합니다. Visual Studio 인스톨러에서 SQL Server Express LocalDB를 데이터 저장 및 처리 워크로드의 일부로 또는 개별 구성 요소로 설치할 수 있습니다.

  2. 다음 단계에 따라 Northwind 샘플 데이터베이스를 설치합니다.

    1. Visual Studio에서 SQL Server 개체 탐색기 창을 엽니다. (SQL Server 개체 탐색기는 Visual Studio 설치 관리자에서 데이터 스토리지 및 처리 워크로드의 일부로 설치됩니다.) SQL Server 노드를 확장합니다. LocalDB 인스턴스를 마우스 오른쪽 단추로 클릭하고 새 쿼리 선택합니다.

      쿼리 편집기 창이 열립니다.

    2. Northwind Transact-SQL 스크립트를 클립보드에 복사합니다. 이 T-SQL 스크립트는 Northwind 데이터베이스를 처음부터 만들고 데이터로 채웁니다.

    3. T-SQL 스크립트를 쿼리 편집기에 붙여넣은 다음 실행 단추를 선택합니다.

      잠시 후 쿼리 실행이 완료되고 Northwind 데이터베이스가 만들어집니다.

Windows Forms 애플리케이션 만들기

첫 번째 단계는 Windows Forms 앱(.NET Framework)을 만드는 것입니다. C# 또는 Visual Basic을 사용하여 Windows Forms 앱 프로젝트 형식을 사용하여 프로젝트를 만듭니다.

비고

이 자습서의 코드는 C# 및 Visual Basic에서 사용할 수 있습니다. 이 페이지의 코드 언어를 C# 및 Visual Basic 간에 전환하려면 오른쪽 페이지의 맨 위에 있는 코드 언어 전환기를 사용합니다.

데이터베이스에서 데이터 원본 만들기

이 단계에서는 데이터 원본 구성 마법사 를 사용하여 Northwind 샘플 데이터베이스의 Region 테이블을 기반으로 데이터 원본을 만듭니다. 연결을 만들려면 Northwind 샘플 데이터베이스에 액세스할 수 있어야 합니다. Northwind 샘플 데이터베이스 설정에 대한 자세한 내용은 방법: 샘플 데이터베이스 설치를 참조하세요.

데이터 원본을 만들려면

  1. 데이터 메뉴에서 데이터 원본 표시를 선택합니다.

    데이터 원본 창이 열립니다.

  2. 데이터 원본 창에서 새 데이터 원본 추가를 선택하여 데이터 원본 구성 마법사를 시작합니다.

  3. 데이터 원본 유형 선택 화면에서 데이터베이스를 선택한 다음, 다음을 선택합니다.

  4. 데이터 연결 선택 화면에서 다음 중 하나를 수행합니다.

    • Northwind 샘플 데이터베이스에 대한 데이터 연결을 드롭다운 목록에서 사용할 수 있는 경우 선택합니다.

      -또는-

    • 새 연결을 선택하여 연결 추가/수정 대화 상자를 시작합니다.

  5. 데이터베이스에 암호가 필요한 경우 중요한 데이터를 포함하는 옵션을 선택하고 다음을 선택합니다.

  6. 애플리케이션 구성 파일 화면에 연결 문자열 저장 화면에서 다음을 선택합니다.

  7. 데이터베이스 개체 선택 화면에서 테이블 노드를 확장합니다.

  8. Region 테이블을 선택한 다음 마침을 선택합니다.

    NorthwindDataSet이 프로젝트에 추가되고 테이블이 Region데이터 원본 창에 나타납니다.

폼에 컨트롤을 추가하여 데이터 표시

데이터 원본 창에서 항목을 폼으로 끌어 데이터 바인딩된 컨트롤을 만듭니다.

Windows 폼에서 데이터 바인딩된 컨트롤을 만들려면 데이터 원본 창에서 폼으로 주 지역 노드를 끌어옵니다.

DataGridView 레코드 탐색을 위한 컨트롤 및 도구 모음(BindingNavigator)이 폼에 나타납니다. NorthwindDataSet , RegionTableAdapter및 BindingSourceBindingNavigator 구성 요소 트레이에 나타납니다.

개별 TableAdapter DbDirect 메서드를 호출하는 단추를 추가하려면

  1. 도구 상자에서 Form1(RegionDataGridView 아래)로 세 개의 Button 컨트롤을 끕니다.

  2. 각 단추에서 다음 이름 및 텍스트 속성을 설정합니다.

    이름 문자 메시지
    InsertButton 삽입
    UpdateButton 업데이트
    DeleteButton 삭제하다

데이터베이스에 새 레코드를 삽입하는 코드를 추가하려면

  1. InsertButton을 선택하여 클릭 이벤트에 대한 이벤트 처리기를 만들고 코드 편집기에서 양식을 엽니다.

  2. InsertButton_Click 이벤트 처리기를 다음 코드로 바꿉다.

    private void InsertButton_Click(object sender, EventArgs e)
{
    Int32 newRegionID = 5;
    String newRegionDescription = "NorthEastern";

    try
    {
        regionTableAdapter1.Insert(newRegionID, newRegionDescription);
    }
    catch (Exception ex)
    {
        MessageBox.Show("Insert Failed");
    }
    RefreshDataset();
}


private void RefreshDataset()
{
    this.regionTableAdapter1.Fill(this.northwindDataSet1.Region);
}

    비고

    Visual Studio 버전 및 사용한 프로젝트 템플릿에 따라 이 코드에 사용된 변수 이름 regionTableAdapterregionTableAdapter1 에 생성된 코드에 후행 1이 있거나 없을 수 있습니다. 코드에서 올바른 이름을 어디에나 사용할 수 있도록 수정합니다. Visual Studio에서는 이름이 잘못된 부분에 빨간색 물결선이 표시됩니다.

데이터베이스에서 레코드를 업데이트하는 코드를 추가하려면

  1. UpdateButton을 두 번 클릭하여 클릭 이벤트에 대한 이벤트 처리기를 만들고 코드 편집기에서 양식을 엽니다.

  2. UpdateButton_Click 이벤트 처리기를 다음 코드로 바꿉다.

    private void UpdateButton_Click(object sender, EventArgs e)
{
    Int32 newRegionID = 5;
    
    try
    {
        regionTableAdapter1.Update(newRegionID, "Updated Region Description", 5, "NorthEastern");
    }
    catch (Exception ex)
    {
        MessageBox.Show("Update Failed");
    }
    RefreshDataset();
}

데이터베이스에서 레코드를 삭제하는 코드를 추가하려면

  1. DeleteButton을 선택하여 클릭 이벤트에 대한 이벤트 처리기를 만들고 코드 편집기에서 양식을 엽니다.

  2. DeleteButton_Click 이벤트 처리기를 다음 코드로 바꿉다.

    private void DeleteButton_Click(object sender, EventArgs e)
{
    try
    {
        regionTableAdapter1.Delete(5, "Updated Region Description");
    }
    catch (Exception ex)
    {
        MessageBox.Show("Delete Failed");
    }
    RefreshDataset();
}

애플리케이션 실행

  • F5 키를 선택하여 애플리케이션을 실행합니다.

  • 삽입 단추를 선택하고 새 레코드가 표에 표시되는지 확인합니다.

  • 업데이트 단추를 선택하고 그리드에서 레코드가 업데이트되었는지 확인합니다.

  • 삭제 단추를 선택하고 그리드에서 레코드가 제거되었는지 확인합니다.

다음 단계

애플리케이션 요구 사항에 따라 데이터 바인딩된 양식을 만든 후 수행할 수 있는 몇 가지 단계가 있습니다. 이 자습서에서 수행할 수 있는 몇 가지 향상된 기능은 다음과 같습니다.

  • 양식에 검색 기능 추가

  • 데이터 원본 창 내에서 마법사를 사용하여 DataSet 구성 을 선택하여 데이터 세트에 테이블을 추가 합니다 . 관련 노드를 폼으로 끌어 관련 데이터를 표시하는 컨트롤을 추가할 수 있습니다. 자세한 내용은 데이터 세트의 관계를 참조하세요.

관련 콘텐츠

  • Last updated on