자습서: Visual Studio에서 C# 및 ASP.NET Core 시작

  • 아티클

ASP.NET Core를 사용한 C# 개발을 위한 이 자습서에서는 Visual Studio에서 C# ASP.NET Core 웹앱을 만듭니다.

이 자습서에서는 다음을 수행하는 방법을 보여 줍니다.

  • Visual Studio 프로젝트 만들기
  • C# ASP.NET Core 웹앱 만들기
  • 웹앱 변경
  • IDE 기능 살펴보기
  • 웹앱 실행

필수 조건

이 자습서를 완료하려면 Visual Studio가 필요합니다. 무료 버전은 Visual Studio 다운로드 페이지를 방문하세요.

프로젝트 만들기

먼저 ASP.NET Core 프로젝트를 만듭니다. 프로젝트 유형에는 완벽하게 작동하는 웹 사이트를 빌드하는 데 필요한 모든 템플릿 파일이 함께 제공됩니다.

  1. 시작 창에서 새 프로젝트 만들기를 선택합니다.

    Screenshot shows the start window for Visual Studio. Create a new project option is highlighted.

  2. 새 프로젝트 만들기 창의 언어 목록에서 C#을 선택합니다. 그런 다음, 플랫폼 목록에서 Windows를 선택하고 프로젝트 형식 목록에서 웹을 선택합니다.

    언어, 플랫폼 및 프로젝트 형식 필터를 적용한 후 ASP.NET Core 웹앱 템플릿을 선택하고 다음을 선택합니다.

    Screenshot that shows the ASP.NET Core Web App project template highlighted in the New Project dialog box in Visual Studio.

    참고 항목

    ASP.NET Core 웹앱 템플릿이 표시되지 않으면 새 프로젝트 만들기 창에서 설치할 수 있습니다.

    원하는 항목을 찾지 못하시겠습니까? 템플릿 목록의 맨 아래에 있는 메시지에서 추가 도구 및 기능 설치 링크를 선택합니다.

    Screenshot shows the Install more tools and features link that is part of the Not finding what you're looking for message.

    Visual Studio 설치 관리자 ASP.NET 및 웹 개발을 선택합니다.

    Screenshot shows the dot NET Core cross-platform development workload in the Visual Studio Installer.

    Visual Studio 설치 관리자에서 수정을 선택합니다. 작업을 저장하라는 메시지가 표시될 수 있습니다. 계속을 선택하여 워크로드를 설치합니다.

    “프로젝트 만들기” 프로시저의 2단계로 돌아갑니다.

  3. 새 프로젝트 구성 창에서 프로젝트 이름 필드에 MyCoreApp을 입력합니다. 그런 후에 다음을 선택합니다.

    Screenshot that shows the Configure your new project window in Visual Studio with MyCoreApp entered in the Project name field.

  4. 추가 정보 창의 대상 프레임워크 필드에 .NET Core 3.1이 표시되는지 확인합니다.

    이 창에서 Docker 지원을 사용하도록 설정하고 인증 지원을 추가할 수 있습니다. 인증 형식에 대한 드롭다운 메뉴에는 다음과 같은 네 가지 옵션이 있습니다.

    • 없음: 인증 없음.
    • 개별 계정: 이러한 인증은 로컬 또는 Azure 기반 데이터베이스에 저장됩니다.
    • Microsoft ID 플랫폼: 이 옵션은 인증에 Microsoft Entra ID 또는 Microsoft 365를 사용합니다.
    • Windows: 인트라넷 애플리케이션에 적합합니다.

    Docker 사용 확인란을 선택 취소한 상태로 두고 인증 유형에 대해 없음을 선택합니다.

    Screenshot that shows the default settings in the Additional information window where the target framework is set to .NET Core 3.1.

  5. 만들기를 실행합니다.

Visual Studio에서 새 프로젝트를 엽니다.

  1. 시작 창에서 새 프로젝트 만들기를 선택합니다.

    Screenshot shows the start window for Visual Studio. Create a new project option is highlighted.

  2. 새 프로젝트 만들기 창의 언어 목록에서 C#을 선택합니다. 그런 다음, 플랫폼 목록에서 Windows를 선택하고 프로젝트 형식 목록에서 웹을 선택합니다.

    언어, 플랫폼 및 프로젝트 형식 필터를 적용한 후 ASP.NET Core 웹앱 템플릿을 선택하고 다음을 선택합니다.

    Screenshot that shows the ASP.NET Core Web App project template selected and highlighted on the Create a new project page.

    참고 항목

    ASP.NET Core 웹앱 템플릿이 표시되지 않으면 새 프로젝트 만들기 창에서 설치할 수 있습니다.

    원하는 항목을 찾지 못하시겠습니까? 템플릿 목록의 맨 아래에 있는 메시지에서 추가 도구 및 기능 설치 링크를 선택합니다.

    Screenshot shows the Install more tools and features link that is part of the Not finding what you're looking for message.

    Visual Studio 설치 관리자 ASP.NET 및 웹 개발 워크로드를 선택합니다.

    Screenshot shows the ASP.NET and web development workload in the Visual Studio Installer.

    Visual Studio 설치 관리자에서 수정을 선택합니다. 작업을 저장하라는 메시지가 표시될 수 있습니다. 계속을 선택하여 워크로드를 설치합니다.

    “프로젝트 만들기” 프로시저의 2단계로 돌아갑니다.

  3. 새 프로젝트 구성 창에서 프로젝트 이름 필드에 MyCoreApp을 입력합니다. 그런 후에 다음을 선택합니다.

    Screenshot that shows the Configure your new project window in Visual Studio with MyCoreApp entered in the Project name field.

  4. 추가 정보 창에서 .NET 8.0이 대상 프레임워크 필드에 표시되는지 확인합니다.

    이 창에서 Docker 지원을 사용하도록 설정하고 인증 지원을 추가할 수 있습니다. 인증 형식에 대한 드롭다운 메뉴에는 다음과 같은 네 가지 옵션이 있습니다.

    • 없음: 인증 없음.
    • 개별 계정: 이러한 인증은 로컬 또는 Azure 기반 데이터베이스에 저장됩니다.
    • Microsoft ID 플랫폼: 이 옵션은 인증에 Microsoft Entra ID 또는 Microsoft 365를 사용합니다.
    • Windows: 인트라넷 애플리케이션에 적합합니다.

    Docker 사용 확인란을 선택 취소한 상태로 두고 인증 유형에 대해 없음을 선택합니다.

    Screenshot that shows the default settings in the Additional information window where the target framework is set to .NET 8.0.

  5. 만들기를 실행합니다.

Visual Studio에서 새 프로젝트를 엽니다.

솔루션 정보

이 솔루션은 Razor 페이지 디자인 패턴을 따릅니다. 이는 Razor 페이지 자체 내에 모델 및 컨트롤러 코드를 포함하도록 간소화된 MVC(Model-View-Controller) 디자인 패턴과 다릅니다.

솔루션 둘러보기

  1. 프로젝트 템플릿은 MyCoreApp이라는 단일 ASP.NET Core 프로젝트로 솔루션을 만듭니다. 해당 콘텐츠를 보려면 솔루션 탐색기 탭을 선택합니다.

    Screenshot shows the MyCoreApp project selected in the Solution Explorer in Visual Studio.

  2. Pages 폴더를 펼칩니다.

    Screenshot shows the contents of the Pages folder in the the Solution Explorer in Visual Studio..

  3. Index.cshtml 파일을 선택하고 코드 편집기에서 파일을 봅니다.

    Screenshot shows the Index dot c s h t m l file open in the Visual Studio code editor.

  4. 각 .cshtml 파일에는 연결된 코드 파일이 있습니다. 편집기에서 코드 파일을 열려면 솔루션 탐색기에서 Index.cshtml 노드를 펼치고 Index.cshtml.cs 파일을 선택합니다.

    Screenshot shows Index dot c s h t m l file selected in the Solution Explorer in Visual Studio.

  5. 코드 편집기에서 Index.cshtml.cs 파일을 살펴봅니다.

    Screenshot shows the Index dot c s h t m l dot c s file open in the Visual Studio code editor.

  6. 프로젝트에는 웹 사이트의 루트인 wwwroot 폴더가 포함되어 있습니다. 내용을 보려면 폴더를 확장합니다.

    Screenshot shows the w w w root folder selected in the Solution Explorer in Visual Studio.

    CSS, 이미지 및 JavaScript 라이브러리와 같은 정적 사이트 콘텐츠를 원하는 경로에 직접 배치할 수 있습니다.

    프로젝트에는 런타임에 웹앱을 관리하는 구성 파일도 포함되어 있습니다. 기본 애플리케이션 구성은 appsettings.json에 저장됩니다. 하지만 appsettings.Development.json을 사용하여 이러한 설정을 재정의할 수 있습니다.

  7. appsettings.json 파일을 확장하여 appsettings.Development.json 파일을 봅니다.

    Screenshot shows appsettings dot j son selected and expanded in the Solution Explorer in Visual Studio.

실행, 디버그 및 변경

  1. 도구 모음에서 IIS Express 단추를 선택하여 디버그 모드에서 앱을 빌드하고 실행합니다. 또는 F5 키를 누르거나 메뉴 모음으로 이동하여 디버그>디버깅 시작을 선택합니다.

    Screenshot shows the I I S Express button highlighted in the toolbar in Visual Studio.

    참고 항목

    웹 서버 'IIS Express'에 연결할 수 없음이라는 오류 메시지를 받는 경우 Visual Studio를 닫은 후 프로그램을 관리자 권한으로 다시 시작합니다. 시작 메뉴에서 Visual Studio 아이콘을 마우스 오른쪽 단추로 클릭한 다음 상황에 맞는 메뉴에서 관리자 권한으로 실행 옵션을 선택하여 이 작업을 수행할 수 있습니다.

    IIS SSL Express 인증서를 허용할 것인지를 묻는 메시지가 표시될 수도 있습니다. 웹 브라우저에서 코드를 보려면 예를 선택한 다음, 후속 보안 경고 메시지가 표시되면 예를 선택합니다.

  2. Visual Studio가 브라우저 창을 시작합니다. 메뉴 모음에 홈 및 개인 정보 페이지가 표시됩니다.

  3. 메뉴 모음에서 개인 정보를 선택합니다. 브라우저의 개인 정보 보호 페이지는 Privacy.cshtml 파일에 설정된 텍스트를 렌더링합니다.

    Screenshot shows the MyCoreApp Privacy page with the following text: Use this page to detail your site's privacy policy.

  4. Visual Studio로 돌아가서 Shift+F5를 눌러 디버깅을 중지합니다. 이렇게 하면 브라우저 창의 프로젝트가 닫힙니다.

  5. Visual Studio에서 편집을 위해 Privacy.cshtml을 엽니다. 그런 다음, Use this page to detail your site's privacy policy라는 문장을 삭제하고 그 대신 This page is under construction as of @ViewData["TimeStamp"]라는 문장으로 바꿉니다.

    Screenshot shows the Privacy dot c s h t m l file open in the Visual Studio code editor with the updated text.

  6. 이제 코드를 변경합시다. Privacy.cshtml.cs를 선택합니다. 그런 다음, 다음 바로 가기를 사용하여 파일 맨 위에서 using 지시문을 정리합니다.

    마우스로 가리키거나 회색으로 표시된 using 지시문을 선택합니다. 빠른 작업 전구가 캐리트 아래 또는 왼쪽 여백에 나타납니다. 전구 메뉴를 선택한 후 불필요한 Using 제거를 선택합니다.

    Screenshot shows the Privacy dot c s h t m l file in the Visual Studio code editor with the Quick Actions tooltip exposed for a greyed out using directive.

    이제 변경 내용 미리 보기를 선택하여 변경 내용을 확인합니다.

    Screenshot shows the Preview Changes dialog box. The dialog box shows the directive being removed, and previews the code change after the removal.

    적용을 선택합니다. Visual Studio가 파일에서 불필요한 using 지시문을 삭제합니다.

  7. 그런 다음, OnGet() 메서드에서 본문을 다음 코드로 변경합니다.

    public void OnGet()
{
   string dateTime = DateTime.Now.ToShortDateString();
   ViewData["TimeStamp"] = dateTime;
}

  8. DateTime 아래에 물결선 밑줄이 나타납니다. 물결선 밑줄이 표시되는 이유는 이 형식이 범위에 없기 때문입니다.

    Screenshot shows an error mark, in the form of a wavy underline, for DateTime in the Visual Studio code editor.

    오류 목록 도구 모음을 열고 같은 오류가 나열되는지 확인합니다. 오류 목록 도구 모음이 표시되지 않으면 상단 메뉴 모음으로 이동해 보기>오류 목록을 선택합니다.

    Screenshot shows the Error List toolbar in Visual Studio with DateTime listed.

  9. 이 오류를 해결해 보겠습니다. 코드 편집기에서 오류가 있는 줄에 커서를 놓고 왼쪽 여백에서 [빠른 작업] 전구 메뉴를 선택합니다. 그런 다음, 드롭다운 메뉴에서 using System;을 선택하여 이 지시문을 파일 맨 위에 추가하고 오류를 해결합니다.

    Screenshot shows the Quick Actions options from its drop-down menu with a mouseover on using System.

  10. F5 키를 눌러 웹 브라우저에서 프로젝트를 엽니다.

  11. 웹 사이트의 맨 위에서 개인 정보를 선택하여 변경 내용을 살펴봅니다.

    Screenshot showing the updated Privacy page that includes the changes you made.

  12. 웹 브라우저를 닫고 Shift+F5를 눌러 디버깅을 중지합니다.

홈페이지 변경

  1. 솔루션 탐색기에서 Pages 폴더를 확장한 다음, Index.cshtml을 선택합니다.

    Screenshot shows Index dot c s h t m l selected under the Pages node in the Solution Explorer.

    Index.cshtml 파일은 웹 브라우저에서 실행되는 웹앱의 홈 페이지에 해당합니다.

    Screenshot shows the Home page for the web app in the browser window.

    코드 편집기에서 홈 페이지에 표시되는 텍스트에 대한 HTML 코드가 표시됩니다.

    Screenshot shows the Index dot c s h t m l file for the Home page in the Visual Studio code editor.

  2. 시작 텍스트를 Hello World!로 변경합니다

    Screenshot shows the Index dot c s h t m l file in the Visual Studio code editor with the Welcome text changed to Hello World!.

  3. IIS Express를 선택하거나 Ctrl+F5를 눌러 앱을 실행하고 웹 브라우저에서 엽니다.

    Screenshot shows the IIS Express button highlighted in the toolbar for Visual Studio.

  4. 웹 브라우저에서 홈 페이지에 새 변경 내용이 표시됩니다.

    Screenshot shows the Home page for the web app in the browser window. The updated text says Hello World!

  5. 웹 브라우저를 닫고 Shift+F5 키를 눌러 디버깅을 중지하고 프로젝트를 저장합니다. 이제 Visual Studio를 닫을 수 있습니다.

솔루션 둘러보기

  1. 프로젝트 템플릿은 MyCoreApp이라는 단일 ASP.NET Core 프로젝트로 솔루션을 만듭니다. 해당 콘텐츠를 보려면 솔루션 탐색기 탭을 선택합니다.

    Screenshot shows the MyCoreApp project selected and its content in the Solution Explorer in Visual Studio.

  2. Pages 폴더를 펼칩니다.

    Screenshot shows the contents of the Pages folder in the Solution Explorer.

  3. Index.cshtml 파일을 선택한 다음, 코드 편집기에서 살펴봅니다.

    Screenshot shows the Index.cshtml file open in the Visual Studio Code editor.

  4. 각 .cshtml 파일에는 연결된 코드 파일이 있습니다. 편집기에서 코드 파일을 열려면 솔루션 탐색기에서 Index.cshtml 노드를 펼치고 Index.cshtml.cs 파일을 선택합니다.

    Screenshot shows Index.cshtml file selected in the Solution Explorer in Visual Studio.

  5. 코드 편집기에서 Index.cshtml.cs 파일을 살펴봅니다.

    Screenshot shows the Index.cshtml.cs file open in the Visual Studio Code editor.

  6. 프로젝트에는 웹 사이트의 루트인 wwwroot 폴더가 포함되어 있습니다. 내용을 보려면 폴더를 확장합니다.

    Screenshot shows the w w w root folder selected in the Solution Explorer in Visual Studio.

    CSS, 이미지 및 JavaScript 라이브러리와 같은 정적 사이트 콘텐츠를 원하는 경로에 직접 배치할 수 있습니다.

  7. 프로젝트에는 런타임에 웹앱을 관리하는 구성 파일도 포함되어 있습니다. 기본 애플리케이션 구성은 appsettings.json에 저장됩니다. 하지만 appsettings.Development.json을 사용하여 이러한 설정을 재정의할 수 있습니다. appsettings.json 파일을 확장하여 appsettings.Development.json 파일을 봅니다.

    Screenshot shows appsettings.json selected and expanded, which exposes appsettings.Development.json, in the Solution Explorer in Visual Studio.

실행, 디버그 및 변경

  1. 도구 모음에서 IIS Express 단추를 선택하여 디버그 모드에서 앱을 빌드하고 실행합니다. 또는 F5 키를 누르거나 메뉴 모음으로 이동하여 디버그>디버깅 시작을 선택합니다.

    Screenshot shows the I I S Express button highlighted in the toolbar in Visual Studio.

    참고 항목

    웹 서버 'IIS Express'에 연결할 수 없음이라는 오류 메시지를 받는 경우 Visual Studio를 닫은 후 프로그램을 관리자 권한으로 다시 시작합니다. 시작 메뉴에서 Visual Studio 아이콘을 마우스 오른쪽 단추로 클릭한 다음 상황에 맞는 메뉴에서 관리자 권한으로 실행 옵션을 선택하여 이 작업을 수행할 수 있습니다.

    IIS SSL Express 인증서를 허용할 것인지를 묻는 메시지가 표시될 수도 있습니다. 웹 브라우저에서 코드를 보려면 예를 선택한 다음, 후속 보안 경고 메시지가 표시되면 예를 선택합니다.

  2. Visual Studio가 브라우저 창을 시작합니다. 메뉴 모음에 홈 및 개인 정보 페이지가 표시됩니다.

  3. 메뉴 모음에서 개인 정보를 선택합니다. 브라우저의 개인 정보 보호 페이지는 Privacy.cshtml 파일에 설정된 텍스트를 렌더링합니다.

    Screenshot shows the MyCoreApp Privacy page with the following text: Use this page to detail your site's privacy policy.

  4. Visual Studio로 돌아가서 Shift+F5를 눌러 디버깅을 중지합니다. 이렇게 하면 브라우저 창의 프로젝트가 닫힙니다.

  5. Visual Studio에서 편집을 위해 Privacy.cshtml을 엽니다. 그런 다음, Use this page to detail your site's privacy policy라는 문장을 삭제하고 그 대신 This page is under construction as of @ViewData["TimeStamp"]라는 문장으로 바꿉니다.

    Screenshot shows the Privacy.cshtml file open in the Visual Studio Code editor with the updated text.

  6. 이제 코드를 변경합시다. Privacy.cshtml.cs를 선택합니다. 다음 바로 가기를 선택하여 파일 맨 위에 있는 using 지시문을 정리합니다.

    마우스로 가리키거나 회색으로 표시된 using 지시문을 선택합니다. 빠른 작업 전구가 캐리트 아래 또는 왼쪽 여백에 나타납니다. 전구를 선택한 다음 불필요한 사용 제거 옆에 있는 확장 화살표를 선택합니다.

    Screenshot shows the Privacy.cshtml file in the Visual Studio Code editor with the Quick Actions tooltip open and Preview changes highlighted.

    이제 변경 내용 미리 보기를 선택하여 변경 내용을 확인합니다.

    Screenshot shows the Preview Changes dialog box. The dialog box shows the directive being removed, and previews the code change after the removal.

    적용을 선택합니다. Visual Studio가 파일에서 불필요한 using 지시문을 삭제합니다.

  7. 다음으로 DateTime.ToString 메서드를 사용하여 문화권 또는 지역에 대해 서식이 지정된 현재 날짜에 대한 문자열을 만듭니다.

    • 메서드의 첫 번째 인수는 날짜를 표시하는 방법을 지정합니다. 이 예제에서는 간단한 날짜 형식을 나타내는 형식 지정자(d)를 사용합니다.
    • 두 번째 인수는 날짜의 문화권이나 지역을 지정하는 CultureInfo 개체입니다. 두 번째 인수는 특히 날짜에 포함된 단어의 언어와 사용되는 구분 기호의 유형을 결정합니다.

    OnGet() 메서드의 본문을 다음 코드로 변경합니다.

    public void OnGet()
{
   string dateTime = DateTime.Now.ToString("d", new CultureInfo("en-US"));
   ViewData["TimeStamp"] = dateTime;
}

  8. 다음 using 지시문은 파일 맨 위에 자동으로 추가됩니다.

    using System.Globalization;

    System.Globalization에는 CultureInfo 클래스가 포함되어 있습니다.

  9. F5 키를 눌러 웹 브라우저에서 프로젝트를 엽니다.

  10. 웹 사이트의 맨 위에서 개인 정보를 선택하여 변경 내용을 살펴봅니다.

    Screenshot showing the Privacy page of the MyCoreApp that includes the changes made to add the date.

  11. 웹 브라우저를 닫고 Shift+F5를 눌러 디버깅을 중지합니다.

홈페이지 변경

  1. 솔루션 탐색기에서 Pages 폴더를 확장한 다음, Index.cshtml을 선택합니다.

    Screenshot shows Index.cshtml selected under the Pages node in the Solution Explorer.

    Index.cshtml 파일은 웹 브라우저에서 실행되는 웹앱의 홈 페이지에 해당합니다.

    Screenshot shows the Home page for the web app in the browser window.

    코드 편집기에서 홈 페이지에 표시되는 텍스트에 대한 HTML 코드가 표시됩니다.

    Screenshot shows the Index.cshtml file for the Home page in the Visual Studio Code editor.

  2. 시작 텍스트를 Hello World!로 변경합니다

    Screenshot shows the Index.cshtml file in the Visual Studio Code editor with the 'Welcome' text changed to 'Hello World!'.

  3. IIS Express를 선택하거나 Ctrl+F5를 눌러 앱을 실행하고 웹 브라우저에서 엽니다.

    Screenshot shows the IIS Express button highlighted in the toolbar for Visual Studio.

  4. 웹 브라우저에서 홈 페이지에 새 변경 내용이 표시됩니다.

    Screenshot shows the Home page for the web app in the browser window. The updated text says 'Hello World!'

  5. 웹 브라우저를 닫고 Shift+F5 키를 눌러 디버깅을 중지하고 프로젝트를 저장합니다. 이제 Visual Studio를 닫을 수 있습니다.

다음 단계

축하합니다. 이 자습서를 마쳤습니다. C#, ASP.NET Core 및 Visual Studio IDE를 이해하는 데 도움이 되었기를 바랍니다. C# 및 ASP.NET을 사용하여 웹앱 또는 웹 사이트를 만드는 방법에 대해 자세히 알아보려면 다음 자습서를 계속 진행하세요.

ASP.NET Core를 사용하여 Razor 페이지 웹앱 만들기를 참조하세요.

또는 Docker를 사용하여 웹앱을 컨테이너화하는 방법을 알아보세요.

Visual Studio의 컨테이너 도구

참고 항목

Visual Studio를 사용하여 Azure App Service에 웹앱 게시