Share via


dotnet aspnet-codegenerator

작성자: Rick Anderson

dotnet aspnet-codegenerator - ASP.NET Core 스캐폴딩 엔진을 실행합니다. dotnet aspnet-codegenerator는 명령줄에서 스캐폴딩하는 경우에만 필요하며, Visual Studio에서 스캐폴딩을 사용하는 경우에는 필요하지 않습니다.

Install and update aspnet-codegenerator 설치 및 업데이트

.NET SDK를 설치합니다.

dotnet aspnet-codegenerator는 설치가 필요한 전역 도구입니다. 다음 명령은 dotnet aspnet-codegenerator 도구의 안정적인 최신 버전을 설치합니다.

dotnet tool install -g dotnet-aspnet-codegenerator

참고 항목

기본적으로 설치할 .NET 이진 파일의 아키텍처는 현재 실행 중인 OS 아키텍처를 나타냅니다. 다른 OS 아키텍처를 지정하려면 dotnet tool install, --arch 옵션을 참조하세요. 자세한 내용은 GitHub 이슈 dotnet/AspNetCore.Docs #29262를 참조하세요.

다음 명령은 dotnet aspnet-codegenerator를 설치된 .NET Core SDK에서 사용 가능한 안정적인 최신 버전으로 업데이트합니다.

dotnet tool update -g dotnet-aspnet-codegenerator

aspnet-codegenerator 제거

문제를 해결하려면 aspnet-codegenerator를 제거해야 할 수 있습니다. 예를 들어, aspnet-codegenerator의 미리 보기 버전을 설치한 경우 릴리스 버전을 설치하기 전에 제거해야 합니다.

다음 명령은 dotnet aspnet-codegenerator 도구를 제거하고 안정적인 최신 버전을 설치합니다.

dotnet tool uninstall -g dotnet-aspnet-codegenerator
dotnet tool install -g dotnet-aspnet-codegenerator

개요

dotnet aspnet-codegenerator [arguments] [-p|--project] [-n|--nuget-package-dir] [-c|--configuration] [-tfm|--target-framework] [-b|--build-base-path] [--no-build] 
dotnet aspnet-codegenerator [-h|--help]

설명

dotnet aspnet-codegenerator 전역 명령은 ASP.NET Core 코드 생성기 및 스캐폴딩 엔진을 실행합니다.

인수

generator

실행할 코드 생성기입니다. 다음 생성기를 사용할 수 있습니다.

생성기 연산
area 영역 스캐폴딩
controller 컨트롤러 스캐폴딩
identity Identity 스캐폴드
razorpage Razor Pages 스캐폴드
view 보기 스캐폴딩

옵션

-n|--nuget-package-dir

NuGet 패키지 디렉터리를 지정합니다.

-c|--configuration {Debug|Release}

빌드 구성을 정의합니다. 기본값은 Debug입니다.

-tfm|--target-framework

사용할 대상 프레임워크입니다. 예: net46.

-b|--build-base-path

빌드 기본 경로입니다.

-h|--help

명령에 대한 간단한 도움말을 출력합니다.

--no-build

실행하기 전에 프로젝트를 빌드하지 않습니다. 또한 --no-restore 플래그를 암시적으로 설정합니다.

-p|--project <PATH>

실행할 프로젝트 파일의 경로를 지정합니다(폴더 이름 또는 전체 경로). 지정하지 않으면 현재 디렉터리로 기본 설정됩니다.

생성기 옵션

다음 섹션에서는 지원되는 생성기에 사용 가능한 옵션에서 설명합니다.

  • 영역
  • Controller
  • Identity
  • Razorpage
  • 보기

Area 옵션

이 도구는 컨트롤러와 보기가 포함된 ASP.NET Core 웹 프로젝트에 사용할 수 있습니다. Razor Pages 앱에는 사용할 수 없습니다.

사용법: dotnet aspnet-codegenerator area AreaNameToGenerate

앞의 명령은 다음 폴더를 생성합니다.

  • Areas
    • AreaNameToGenerate
      • 컨트롤러
      • Data
      • Models
      • Views

Controller 옵션

다음 표에는 aspnet-codegeneratorrazorpage, controllerview에 대한 옵션이 나열되어 있습니다.

옵션 설명
--model 또는 -m 사용할 모델 클래스입니다.
--dataContext 또는 -dc 사용할 DbContext 클래스 또는 생성할 클래스의 이름입니다.
--bootstrapVersion 또는 -b 부트스트랩 버전을 지정합니다. 유효한 값은 3 또는 4입니다. 기본값은 4입니다. 필요하지만 없는 경우에는 지정된 버전의 부트스트랩 파일을 포함하는 wwwroot 디렉터리가 만들어집니다.
--referenceScriptLibraries 또는 -scripts 생성된 뷰에서 스크립트 라이브러리를 참조합니다. 편집 및 만들기 페이지에 _ValidationScriptsPartial을 추가합니다.
--layout 또는 -l 사용할 사용자 지정 레이아웃 페이지입니다.
--useDefaultLayout 또는-udl 뷰의 기본 레이아웃을 사용합니다.
--force 또는 -f 기존 파일을 덮어씁니다.
--relativeFolderPath 또는-outDir 파일을 생성해야 하는 프로젝트의 상대 출력 폴더 경로를 지정합니다. 지정하지 않으면 프로젝트 폴더에 파일이 생성됩니다.
--useSqlite 또는 -sqlite DbContext에서 SQL Server 대신 SQLite를 사용해야 하는지 여부를 지정하는 플래그입니다.

다음 표에는 aspnet-codegenerator controller에 고유한 옵션 목록이 나와 있습니다.

옵션 설명
--controllerName 또는 -name 컨트롤러의 이름입니다.
--useAsyncActions 또는 -async 비동기 컨트롤러 작업을 생성합니다.
--noViews 또는 -nv 보기를 생성하지 않습니다.
--restWithNoViews 또는 -api REST 스타일 API를 사용하여 컨트롤러를 생성합니다. noViews 옵션이 지정된 것으로 간주되며 모든 보기 관련된 옵션이 무시됩니다.
--readWriteActions 또는 -actions 모델 없이 읽기/쓰기 동작이 포함된 컨트롤러를 생성합니다.

-h 스위치를 사용하여 aspnet-codegenerator controller 명령에 대한 도움말을 확인합니다.

dotnet aspnet-codegenerator controller -h

dotnet aspnet-codegenerator controller의 예제는 동영상 모델 스캐폴드를 참조하세요.

Razorpage

Razor Pages는 새 페이지 이름 및 사용할 템플릿을 지정하여 개별적으로 스캐폴드할 수 있습니다. 지원되는 템플릿은 다음과 같습니다.

  • Empty
  • Create
  • Edit
  • Delete
  • Details
  • List

예를 들어 다음 명령은 편집 템플릿을 사용하여 생성하고 MyEdit.cshtml.cs다음을 수행 MyEdit.cshtml 합니다.

dotnet aspnet-codegenerator razorpage MyEdit Edit -m Movie -dc RazorPagesMovieContext -outDir Pages/Movies

일반적으로 템플릿 및 생성된 파일 이름은 지정되지 않으며 다음 템플릿이 생성됩니다.

  • Create
  • Edit
  • Delete
  • Details
  • List

다음 표에는 aspnet-codegeneratorrazorpage, controllerview에 대한 옵션이 나열되어 있습니다.

옵션 설명
--model 또는 -m 사용할 모델 클래스입니다.
--dataContext 또는 -dc 사용할 DbContext 클래스 또는 생성할 클래스의 이름입니다.
--bootstrapVersion 또는 -b 부트스트랩 버전을 지정합니다. 유효한 값은 3 또는 4입니다. 기본값은 4입니다. 필요하지만 없는 경우에는 지정된 버전의 부트스트랩 파일을 포함하는 wwwroot 디렉터리가 만들어집니다.
--referenceScriptLibraries 또는 -scripts 생성된 뷰에서 스크립트 라이브러리를 참조합니다. 편집 및 만들기 페이지에 _ValidationScriptsPartial을 추가합니다.
--layout 또는 -l 사용할 사용자 지정 레이아웃 페이지입니다.
--useDefaultLayout 또는-udl 뷰의 기본 레이아웃을 사용합니다.
--force 또는 -f 기존 파일을 덮어씁니다.
--relativeFolderPath 또는-outDir 파일을 생성해야 하는 프로젝트의 상대 출력 폴더 경로를 지정합니다. 지정하지 않으면 프로젝트 폴더에 파일이 생성됩니다.
--useSqlite 또는 -sqlite DbContext에서 SQL Server 대신 SQLite를 사용해야 하는지 여부를 지정하는 플래그입니다.

다음 표에는 aspnet-codegenerator razorpage에 고유한 옵션 목록이 나와 있습니다.

옵션 설명
--namespaceName 또는 -namespace 생성된 PageModel에 사용할 네임스페이스의 이름입니다.
--partialView 또는 -partial 부분 보기를 생성합니다. 이 옵션이 지정되면 레이아웃 옵션 -l 및 -udl은 무시됩니다.
--noPageModel 또는 -npm 빈 템플릿에 대한 PageModel 클래스를 생성하지 않도록 전환합니다.

-h 스위치를 사용하여 aspnet-codegenerator razorpage 명령에 대한 도움말을 확인합니다.

dotnet aspnet-codegenerator razorpage -h

dotnet aspnet-codegenerator razorpage의 예제는 동영상 모델 스캐폴드를 참조하세요.

보기

View의 이름과 사용할 템플릿을 지정하여 View를 개별적으로 스캐폴드할 수 있습니다. 지원되는 템플릿은 다음과 같습니다.

  • Empty
  • Create
  • Edit
  • Delete
  • Details
  • List

예를 들어 다음 명령은 편집 템플릿을 사용하여 다음을 생성합니다 MyEdit.cshtml.

dotnet aspnet-codegenerator view MyEdit Edit -m Movie -dc MovieContext -outDir Views/Movies

다음 표에는 aspnet-codegeneratorrazorpage, controllerview에 대한 옵션이 나열되어 있습니다.

옵션 설명
--model 또는 -m 사용할 모델 클래스입니다.
--dataContext 또는 -dc 사용할 DbContext 클래스 또는 생성할 클래스의 이름입니다.
--bootstrapVersion 또는 -b 부트스트랩 버전을 지정합니다. 유효한 값은 3 또는 4입니다. 기본값은 4입니다. 필요하지만 없는 경우에는 지정된 버전의 부트스트랩 파일을 포함하는 wwwroot 디렉터리가 만들어집니다.
--referenceScriptLibraries 또는 -scripts 생성된 뷰에서 스크립트 라이브러리를 참조합니다. 편집 및 만들기 페이지에 _ValidationScriptsPartial을 추가합니다.
--layout 또는 -l 사용할 사용자 지정 레이아웃 페이지입니다.
--useDefaultLayout 또는-udl 뷰의 기본 레이아웃을 사용합니다.
--force 또는 -f 기존 파일을 덮어씁니다.
--relativeFolderPath 또는-outDir 파일을 생성해야 하는 프로젝트의 상대 출력 폴더 경로를 지정합니다. 지정하지 않으면 프로젝트 폴더에 파일이 생성됩니다.
--useSqlite 또는 -sqlite DbContext에서 SQL Server 대신 SQLite를 사용해야 하는지 여부를 지정하는 플래그입니다.

다음 표에는 aspnet-codegenerator view에 고유한 옵션 목록이 나와 있습니다.

옵션 설명
--controllerNamespace 또는 -namespace 생성된 컨트롤러에 사용할 네임스페이스의 이름을 지정합니다.
--partialView 또는 -partial 부분 보기를 생성합니다. 이 옵션이 지정되면 다른 레이아웃 옵션(-l 및 -udl)은 무시됩니다.

-h 스위치를 사용하여 aspnet-codegenerator view 명령에 대한 도움말을 확인합니다.

dotnet aspnet-codegenerator view -h

Identity

스캐폴드Identity를 참조하세요.