자습서: .NET을 사용하여 Windows Forms 앱 만들기

이 간단한 자습서에서는 Visual Studio를 사용하여 새 Windows Forms 앱을 만드는 방법을 알아봅니다. 초기 앱을 생성한 후에는 컨트롤을 추가하는 방법과 이벤트를 처리하는 방법을 알아봅니다. 이 자습서를 마치면 목록 상자에 이름을 추가하는 간단한 앱이 완성됩니다.

중요

.NET 7 및 .NET 6에 관한 데스크톱 가이드 설명서는 제작 중입니다.

이 자습서에서는 다음 작업 방법을 알아봅니다.

  • 새 Windows Forms 애플리케이션 만들기
  • 양식에 컨트롤 추가
  • 컨트롤 이벤트를 처리하여 앱 기능 제공
  • 앱 실행

필수 구성 요소

Visual Studio 2022 버전 17.4 이상을 사용하고 .NET 7 및 .NET 6 개별 구성 요소를 모두 설치합니다. Visual Studio 2022 버전 17.4에서 .NET 7 지원이 추가되었습니다.

Windows Forms 앱 만들기

새 앱을 만드는 첫 번째 단계는 Visual Studio를 열고 템플릿을 통해 앱을 생성하는 것입니다.

  1. Visual Studio를 엽니다.

  2. 새 프로젝트 만들기를 선택합니다.

    Create a new Windows Forms project in Visual Studio 2022 for .NET.

  3. 템플릿 검색 상자에 winforms를 입력하고 검색 결과가 나타날 때까지 기다립니다.

  4. 코드 언어 드롭다운에서 C# 또는 Visual Basic을 선택합니다.

  5. 템플릿 목록에서 Windows Forms 앱을 선택하고 다음을 클릭합니다.

    중요

    Windows Forms 앱(.NET Framework) 템플릿을 선택하지 마세요.

    다음 이미지에는 C# 프로젝트 템플릿과 Visual Basic .NET 프로젝트 템플릿이 모두 나와 있습니다. 코드 언어 필터를 적용한 경우 해당 템플릿이 표시됩니다.

    Search for the Windows Forms template in Visual Studio 2022 for .NET.

  6. 새 프로젝트 구성 창에서 프로젝트 이름Names로 설정하고 다음을 클릭합니다.

    위치 경로를 조정하여 프로젝트를 다른 폴더에 저장할 수도 있습니다.

    Configure new Windows Forms project in Visual Studio 2022 for .NET.

  7. 마지막으로 추가 정보 창에서 프레임워크 설정으로 .NET 6.0(장기 지원)을 선택한 다음 만들기를 클릭합니다.

    Select the target framework for a Windows Forms project in Visual Studio 2022.

  1. Visual Studio를 엽니다.

  2. 새 프로젝트 만들기를 선택합니다.

    Create a new Windows Forms project in Visual Studio 2022 for .NET.

  3. 템플릿 검색 상자에 winforms를 입력하고 검색 결과가 나타날 때까지 기다립니다.

  4. 코드 언어 드롭다운에서 C# 또는 Visual Basic을 선택합니다.

  5. 템플릿 목록에서 Windows Forms 앱을 선택하고 다음을 클릭합니다.

    중요

    Windows Forms 앱(.NET Framework) 템플릿을 선택하지 마세요.

    다음 이미지에는 C# 프로젝트 템플릿과 Visual Basic .NET 프로젝트 템플릿이 모두 나와 있습니다. 코드 언어 필터를 적용한 경우 해당 템플릿이 표시됩니다.

    Search for the Windows Forms template in Visual Studio 2022 for .NET.

  6. 새 프로젝트 구성 창에서 프로젝트 이름Names로 설정하고 다음을 클릭합니다.

    위치 경로를 조정하여 프로젝트를 다른 폴더에 저장할 수도 있습니다.

    Configure new Windows Forms project in Visual Studio 2022 for .NET.

  7. 마지막으로 추가 정보 창에서 프레임워크 설정으로 .NET 7.0(장기 지원)을 선택한 다음, 만들기를 클릭합니다.

    Select the target framework for a Windows Forms project in Visual Studio 2022.

앱이 생성되면 Visual Studio에서 기본 양식인 Form1의 디자이너 창이 열립니다. 양식 디자이너가 표시되지 않는 경우 솔루션 탐색기 창에서 양식을 두 번 클릭하여 디자이너 창을 엽니다.

Visual Studio의 중요 부분

Visual Studio의 Windows Forms 지원에는 앱을 만들 때 조작하는 네 가지 중요한 구성 요소가 포함됩니다.

The important components of Visual Studio 2022 you should know when creating a Windows Forms project for .NET.

  1. 솔루션 탐색기

    이 창에는 프로젝트 파일, 코드, 양식, 리소스가 모두 표시됩니다.

  2. 속성

    이 창에는 선택한 항목에 따라 구성할 수 있는 속성 설정이 표시됩니다. 예를 들어 솔루션 탐색기에서 항목을 선택하면 해당 파일과 관련된 속성 설정이 표시됩니다. 디자이너에서 개체를 선택하면 컨트롤 또는 양식과 관련된 설정이 표시됩니다.

  3. 양식 디자이너

    양식용 디자이너입니다. 대화형으로 작동하며, 도구 상자에서 개체를 끌어다 놓을 수 있습니다. 디자이너에서 항목을 선택하여 이동하면 앱 UI(사용자 인터페이스)를 시각적으로 구성할 수 있습니다.

  4. 도구 상자

    도구 상자는 양식에 추가할 수 있는 모든 컨트롤을 포함합니다. 현재 양식에 컨트롤을 추가하려면 컨트롤을 두 번 클릭하거나 컨트롤을 끌어다 놓습니다.

도구 상자가 표시되지 않으면 도구 상자>보기 메뉴 항목을 통해 표시할 수 있습니다.

The view menu with the toolbox item highlighted in a Visual Studio 2022 Windows Forms project.

양식에 컨트롤 추가

Form1 양식 디자이너를 열고 도구 상자 창을 사용하여 다음 컨트롤을 양식에 추가합니다.

  • 레이블
  • 단추
  • 목록 상자
  • 텍스트 상자

다음 설정에 따라 컨트롤 위치 및 크기를 지정할 수 있습니다. 다음 스크린샷과 일치하도록 컨트롤을 시각적으로 이동하거나, 각 컨트롤을 클릭하고 속성 창에서 설정을 구성합니다. 양식 제목 영역을 클릭하여 양식을 선택할 수도 있습니다.

개체 설정
Form 텍스트 Names
크기 268, 180
레이블 위치 12, 9
텍스트 Names
목록 상자 이름 lstNames
위치 12, 27
크기 120, 94
입력란 이름 txtName
위치 138, 26
크기 100, 23
단추 이름 btnAdd
위치 138, 55
크기 100, 23
텍스트 Add Name

디자이너에 다음과 유사한 양식이 표시됩니다.

Visual Studio 2022 designer with the form open for Windows Forms for .NET.

이벤트 처리

이제 양식에 모든 컨트롤이 배치되었으므로 사용자 입력에 응답하는 컨트롤 이벤트를 처리해야 합니다. 양식 디자이너를 열고 다음 단계를 수행합니다.

  1. 양식에서 단추 컨트롤을 선택합니다.

  2. 속성 창에서 이벤트 아이콘 을 클릭하여 단추 이벤트를 나열합니다.

  3. Click 이벤트를 찾은 다음 두 번 클릭하여 이벤트 처리기를 생성합니다.

    이 작업은 다음 코드를 양식에 추가합니다.

    private void btnAdd_Click(object sender, EventArgs e)
    {
    
    }
    
    Private Sub btnAdd_Click(sender As Object, e As EventArgs) Handles btnAdd.Click
    
    End Sub
    

    이 처리기에 추가하는 코드는 txtName 텍스트 상자 컨트롤에 지정된 이름을 lstNames 목록 상자 컨트롤에 추가합니다. 그러나 두 가지 이름 추가 조건을 지정하려고 합니다. 즉, 지정한 이름이 공백이 아니고 사용 중인 이름이 아니어야 합니다.

  4. 다음 코드에서는 lstNames 컨트롤에 이름을 추가하는 방법을 보여 줍니다.

    private void btnAdd_Click(object sender, EventArgs e)
    {
        if (!string.IsNullOrWhiteSpace(txtName.Text) && !lstNames.Items.Contains(txtName.Text))
            lstNames.Items.Add(txtName.Text);
    }
    
    Private Sub btnAdd_Click(sender As Object, e As EventArgs) Handles btnAdd.Click
        If Not String.IsNullOrWhiteSpace(txtName.Text) And Not lstNames.Items.Contains(txtName.Text) Then
            lstNames.Items.Add(txtName.Text)
        End If
    End Sub
    

앱 실행

이제 이벤트가 코딩되었으므로 F5 키를 누르거나 메뉴에서 디버그>디버깅 시작을 선택하여 앱을 실행할 수 있습니다. 양식이 표시되고, 텍스트 상자에 이름을 입력한 다음 단추를 클릭하여 이름을 추가할 수 있습니다.

Running a Windows Forms for .NET app in Visual Studio 2022.

다음 단계