다음을 통해 공유

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

  • 아티클

참고 항목

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

Windows 애플리케이션에서 폼에 데이터를 표시할 때는 도구 상자에서 기존 컨트롤을 선택할 수도 있고, 표준 컨트롤에서는 제공되지 않는 기능이 애플리케이션에 필요한 경우에는 사용자 지정 컨트롤을 작성할 수도 있습니다. 이 연습에서는 DefaultBindingPropertyAttribute를 구현하는 컨트롤을 만드는 방법을 보여줍니다. DefaultBindingPropertyAttribute를 구현하는 컨트롤은 데이터에 바인딩할 수 있는 속성 한 개를 포함할 수 있습니다. 이러한 컨트롤은 TextBox 또는 CheckBox와 비슷합니다.

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

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

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

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

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

  • 새 Windows Forms 앱(.NET Framework) 만들기

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

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

  • DefaultBindingProperty 특성을 구현합니다.

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

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

  • 새 컨트롤에 데이터를 표시할 폼을 만듭니다.

필수 조건

이 자습서를 완료하려면 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 바탕 화면을 선택합니다.

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

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

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

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

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

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

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

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

PhoneNumberBox 컨트롤 디자인

이 연습에서는 기존 MaskedTextBox를 확장하여 PhoneNumberBox 컨트롤을 만듭니다.

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

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

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

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

데이터 바인딩을 지원하는 단순 컨트롤에 대해 DefaultBindingPropertyAttribute를 구현합니다.

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

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

    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 컨트롤을 사용하도록 phone 열 설정

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

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

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

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

  4. Phone 열에서 드롭다운 목록 화살표를 클릭하고 Customize를 선택합니다.

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

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

양식에 컨트롤 추가

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

양식에서 데이터 바인딩 컨트롤을 만들려면 데이터 소스 창에서 양식으로 주 Customers 노드를 끌어오고 Phone 열에 데이터를 표시하는 데 PhoneNumberBox 컨트롤이 사용되는지 확인합니다.

설명 레이블이 있는 데이터 바인딩된 컨트롤이 레코드 탐색을 위한 도구 모음인 BindingNavigator와 함께 폼에 나타납니다. NorthwindDataSet, CustomersTableAdapter, BindingSource 및 BindingNavigator가 구성 요소 트레이에 나타납니다.

애플리케이션 실행

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

다음 단계

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

관련 콘텐츠