ADO.NET으로 복잡한 데이터 바인딩을 지원하는 .NET Framework Windows Forms 사용자 정의 컨트롤 만들기

참고 항목

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

Windows 애플리케이션의 양식에 데이터를 표시하면 도구 상자에서 기존 컨트롤을 선택할 수 있습니다. 또는 애플리케이션에 표준 컨트롤에서 사용할 수 없는 기능이 필요한 경우 사용자 지정 컨트롤을 작성할 수 있습니다. 이 연습에서는 ComplexBindingPropertiesAttribute를 구현하는 컨트롤을 만드는 방법을 보여줍니다. ComplexBindingPropertiesAttribute를 구현하는 컨트롤은 데이터에 바인딩할 수 있는 DataSource 및 DataMember 속성을 포함합니다. 이러한 컨트롤은 DataGridView 또는 ListBox와 비슷합니다.

컨트롤 작성에 관한 자세한 내용은 디자인 타임에 Windows Forms 컨트롤 개발을 참조하세요.

데이터 바인딩 시나리오에 사용할 컨트롤을 작성할 때는 다음 데이터 바인딩 특성 중 하나를 구현해야 합니다.

데이터 바인딩 특성 사용
단일 데이터 열이나 속성을 표시하는 DefaultBindingPropertyAttribute 등의 단순 컨트롤에 대해 TextBox를 구현합니다. 자세한 내용은 단순 데이터 바인딩을 지원하는 Windows Forms 사용자 정의 컨트롤 만들기를 참조하세요.
데이터 목록 또는 테이블을 표시하는 ComplexBindingPropertiesAttribute 등의 컨트롤에 대해 DataGridView를 구현합니다. 이 연습 페이지에서 해당 프로세스에 대해 설명합니다.
데이터 목록 또는 테이블을 표시하는 동시에 단일 열이나 속성도 제공해야 하는 LookupBindingPropertiesAttribute 등의 컨트롤에 대해 ComboBox를 구현합니다. 자세한 내용은 조회 데이터 바인딩을 지원하는 Windows Forms 사용자 정의 컨트롤 만들기를 참조하세요.

이 연습에서는 테이블의 데이터 행을 표시하는 복합 컨트롤을 만듭니다. 이 예에서는 Northwind 샘플 데이터베이스의 Customers 테이블을 사용합니다. 복합 사용자 컨트롤은 사용자 지정 컨트롤의 DataGridView에 Customers 테이블을 표시합니다.

이 연습에서는 다음 방법을 알아봅니다.

• 프로젝트에 새 사용자 정의 컨트롤을 추가합니다.

• 사용자 컨트롤을 시각적으로 디자인합니다.

• ComplexBindingProperty 특성을 구현합니다.

• 데이터 소스 구성 마법사를 사용하여 데이터 세트를 만듭니다.

• 새 복합 컨트롤을 사용하도록 데이터 소스 창에서 Customers 테이블을 설정합니다.

• 새 컨트롤을 데이터 원본 창에서 Form1으로 끌어 추가합니다.

필수 조건

이 자습서를 완료하려면 Visual Studio에 .NET 데스크톱 개발 및 데이터 스토리지 및 처리 워크로드가 설치되어 있어야 합니다. 이를 설치하려면 Visual Studio 설치 관리자를 열고 수정하려는 Visual Studio 버전 옆에 있는 수정(또는 더 보기>수정)을 선택합니다. Visual Studio 수정을 참조하세요.

이 연습에서는 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 앱 프로젝트 만들기

첫 번째 단계는 C# 또는 Visual Basic에 대한 Windows Forms 앱 프로젝트를 만드는 것입니다. 프로젝트 이름을 ComplexControlWalkthrough로 지정합니다.

프로젝트에 사용자 정의 컨트롤 추가

이 연습에서는 사용자 정의 컨트롤에서 데이터 바인딩 가능한 복합 컨트롤을 만들 것이므로 사용자 정의 컨트롤 항목을 프로젝트에 추가합니다.

1. 프로젝트 메뉴에서 사용자 컨트롤 추가를 선택합니다.

2. 이름 영역에 ComplexDataGridView를 입력하고 추가를 클릭합니다.

   ComplexDataGridView 컨트롤이 솔루션 탐색기에 추가되고 디자이너에서 열립니다.

ComplexDataGridView 컨트롤 디자인

DataGridView를 사용자 정의 컨트롤에 추가하려면 도구 상자에서 사용자 정의 컨트롤의 디자인 화면으로 DataGridView를 끌어옵니다.

필요한 데이터 바인딩 특성 추가

데이터 바인딩을 지원하는 복합 컨트롤에 대해 ComplexBindingPropertiesAttribute를 구현할 수 있습니다.

1. ComplexDataGridView 컨트롤을 코드 보기로 전환합니다. (보기 메뉴에서 코드를 선택합니다.)

2. ComplexDataGridView의 코드를 다음 코드로 바꿉니다.

   C#

   using System.Windows.Forms;
   
   namespace CS
   {
       [System.ComponentModel.ComplexBindingProperties("DataSource", "DataMember")]
       public partial class ComplexDataGridView : UserControl
       {
           public object DataSource
           {
               get{ return dataGridView1.DataSource; }
               set{ dataGridView1.DataSource = value; }
           }
   
           public string DataMember
           {
               get{ return dataGridView1.DataMember; }
               set{ dataGridView1.DataMember = value; }
           }
   
           public ComplexDataGridView()
           {
               InitializeComponent();
           }
       }
   }
   

   VB

   <System.ComponentModel.ComplexBindingProperties("DataSource", "DataMember")>
   Public Class ComplexDataGridView
   
       Public Property DataSource() As Object
           Get
               Return DataGridView1.DataSource
           End Get
           Set(ByVal value As Object)
               DataGridView1.DataSource = value
           End Set
       End Property
   
       Public Property DataMember() As String
           Get
               Return DataGridView1.DataMember
           End Get
           Set(ByVal value As String)
               DataGridView1.DataMember = value
           End Set
       End Property
   End Class
   

3. 빌드 메뉴에서 솔루션 빌드를 선택합니다.

데이터베이스에서 데이터 소스 만들기

데이터 소스 구성 마법사를 사용하여 Northwind 샘플 데이터베이스의 Customers 테이블을 기반으로 데이터 소스를 만듭니다.

1. 데이터 소스 창을 열려면 데이터 메뉴에서 데이터 소스 표시를 클릭합니다.

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

3. 데이터 소스 형식 선택 페이지에서 데이터베이스 를 선택하고 다음을 클릭합니다.

4. 데이터 연결 선택 페이지에서 다음 중 한 가지를 수행합니다.

   • Northwind 샘플 데이터베이스에 대한 데이터 연결이 드롭다운 목록에 표시되면 해당 연결을 선택합니다.

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

5. 데이터베이스에 암호가 필요하면 중요한 데이터를 포함하는 옵션을 선택한 후, 다음을 클릭합니다.

6. 애플리케이션 구성 파일에 연결 문자열 저장 페이지에서 다음을 클릭합니다.

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

8. Customers 테이블을 선택한 다음, 마침을 클릭합니다.

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

ComplexDataGridView 컨트롤을 사용하도록 Customers 테이블 설정

데이터 원본 창 내에서 항목을 폼으로 끌기 전에 만들 컨트롤을 설정할 수 있습니다.

1. 디자이너에서 Form1을 엽니다.

2. 데이터 원본 창에서 Customers 노드를 확장합니다.

3. Customers 노드에서 드롭다운 목록 화살표를 클릭하고 Customize를 선택합니다.

4. 데이터 UI 사용자 지정 옵션 대화 상자의 연결된 컨트롤 목록에서 ComplexDataGridView를 선택합니다.

5. Customers 테이블에서 드롭다운 목록 화살표를 클릭하고 컨트롤 목록에서 ComplexDataGridView를 선택합니다.

양식에 컨트롤 추가

데이터 원본 창에서 폼으로 항목을 끌어 데이터 바인딩된 컨트롤을 만들 수 있습니다. 주 Customers 노드를 데이터 원본 창에서 폼으로 끌어서 놓습니다. ComplexDataGridView 컨트롤이 테이블의 데이터를 표시하는 데 사용되는지 확인합니다.

애플리케이션 실행

F5 키를 눌러 애플리케이션을 실행합니다.

다음 단계

애플리케이션 요구 사항에 따라 데이터 바인딩을 지원하는 컨트롤을 만든 후 몇 단계를 더 수행해야 할 수도 있습니다. 일반적으로 수행하는 몇 가지 단계는 다음과 같습니다.

• 다른 애플리케이션에서 다시 사용할 수 있도록 컨트롤 라이브러리에 사용자 지정 컨트롤을 배치합니다.

• 조회 시나리오를 지원하는 컨트롤을 만듭니다. 자세한 내용은 조회 데이터 바인딩을 지원하는 Windows Forms 사용자 정의 컨트롤 만들기를 참조하세요.

관련 콘텐츠

• Windows Forms 컨트롤을 Visual Studio의 데이터에 바인딩
• 데이터 소스 창에서 끌어올 때 만들 컨트롤 설정
• Windows Forms 컨트롤