간단한 데이터 바인딩을 지원하는 .NET Framework Windows Forms 사용자 컨트롤 만들기

Windows 애플리케이션의 양식에 데이터를 표시할 때 도구 상자에서 기존 컨트롤을 선택하거나 애플리케이션에 표준 컨트롤에서 사용할 수 없는 기능이 필요한 경우 사용자 지정 컨트롤을 작성할 수 있습니다. 이 안내에서는 `DefaultBindingPropertyAttribute`를 구현하는 컨트롤을 만드는 방법을 보여 줍니다. 구현하는 컨트롤은 DefaultBindingPropertyAttribute 데이터에 바인딩할 수 있는 하나의 속성을 포함할 수 있습니다. 이러한 컨트롤은 TextBox 또는 CheckBox와 유사합니다.

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

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

이 연습에서는 테이블의 단일 열에서 데이터를 표시하는 간단한 컨트롤을 만듭니다. 이 예제에서는 Northwind 샘플 데이터베이스의 Customers 테이블의 Phone 열을 사용합니다. 간단한 사용자 컨트롤은 MaskedTextBox을 사용하고 마스크를 전화번호로 설정하여 고객의 전화번호를 표준 전화번호 형식으로 표시합니다.

이 연습에서는 다음 작업을 수행하는 방법을 배웁니다.

• 새 Windows Forms 앱(.NET Framework)을 만듭니다.

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

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

• DefaultBindingProperty 특성을 구현합니다.

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

• 새 컨트롤을 사용하도록 데이터 원본 창에서 전화 열을 설정합니다.

• 새 컨트롤에 데이터를 표시하는 양식을 만듭니다.

필수 조건

이 자습서를 완료하려면 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 애플리케이션 만들기

첫 번째 단계는 Windows Forms 앱(.NET Framework)을 만드는 것입니다.

1. Visual Studio의 파일 메뉴에서 새>프로젝트를 선택합니다.

2. 왼쪽 창에서 Visual C# 또는 Visual Basic 을 확장한 다음 , Windows Desktop을 선택합니다.

3. 가운데 창에서 Windows Forms 앱 프로젝트 유형을 선택합니다.

4. 프로젝트 이름을 SimpleControlWalkthrough로 지정한 다음 확인을 선택합니다.

   SimpleControlWalkthrough 프로젝트가 만들어지고 솔루션 탐색기에 추가됩니다.

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

이 연습에서는 사용자 컨트롤에서 간단한 데이터 바인딩 가능 컨트롤을 만듭니다. SimpleControlWalkthrough 프로젝트에 사용자 제어 항목을 추가합니다.

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

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

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

PhoneNumberBox 컨트롤 디자인

이 안내서는 기존 MaskedTextBox을(를) 확장함으로써 PhoneNumberBox 컨트롤을 만듭니다.

1. MaskedTextBox를 도구 상자에서 사용자 컨트롤의 디자인 표면으로 끌어서 놓습니다.

2. 방금 끌어온 스마트 태그를 MaskedTextBox 선택하고 마스크 설정을 선택합니다.

3. 입력 마스크 대화 상자에서 전화 번호를 선택하고 확인을 클릭하여 마스크를 설정합니다.

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

데이터 바인딩을 지원하는 간단한 컨트롤의 경우 다음을 구현합니다 DefaultBindingPropertyAttribute.

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

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

   • C#
   • VB

   using System.Windows.Forms;
   
   namespace CS
   {
       [System.ComponentModel.DefaultBindingProperty("PhoneNumber")]
       public partial class PhoneNumberBox : UserControl
       {
           public string PhoneNumber
           {
               get{ return maskedTextBox1.Text; }
               set{ maskedTextBox1.Text = value; }
           }
   
           public PhoneNumberBox()
           {
               InitializeComponent();
           }
       }
   }
   

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

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

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

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

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

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

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

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

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

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

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

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

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

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

전화 열을 PhoneNumberBox 컨트롤을 사용하도록 설정하세요.

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

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

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

3. 고객 노드의 드롭다운 목록 화살표를 클릭하고 컨트롤 목록에서 세부 정보를 선택합니다.

4. 전화 열에서 드롭다운 목록 화살표를 클릭하고 사용자 지정을 선택합니다.

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

6. 전화 열에서 드롭다운 목록 화살표를 클릭하고 PhoneNumberBox를 선택합니다.

양식에 컨트롤 추가

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

폼에 데이터 바인딩된 컨트롤을 만들려면 데이터 원본 창의 기본 고객 노드를 양식으로 끌어온 다음 PhoneNumberBox 컨트롤을 사용하여 Phone 열에 데이터를 표시하는지 확인합니다.

설명 레이블이 있는 데이터 바인딩된 컨트롤은 레코드 탐색을 위한 도구 모음(BindingNavigator)과 함께 폼에 표시됩니다. NorthwindDataSet, CustomersTableAdapter, BindingSource, 그리고 BindingNavigator가 구성 요소 트레이에 나타납니다.

애플리케이션 실행

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

다음 단계

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

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

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

관련 콘텐츠

• Windows Forms 컨트롤을 Visual Studio의 데이터에 바인딩
• 데이터 원본 창에서 끌 때 생성할 컨트롤을 설정합니다