dotnet aspnet-codegenerator

Gönderen Rick Anderson

dotnet aspnet-codegenerator - ASP.NET Core iskele altyapısını çalıştırır. dotnet aspnet-codegenerator yalnızca komut satırından yapı iskelesi yapmak için gereklidir; Visual Studio ile yapı iskelesi kullanmak gerekmez.

aspnet-codegenerator'ı yükleme ve güncelleştirme

.NET SDK'sını yükleyin.

dotnet aspnet-codegenerator yüklenmesi gereken genel bir araçtır . Aşağıdaki komut aracın en son kararlı sürümünü dotnet aspnet-codegenerator yükler:

dotnet tool install -g dotnet-aspnet-codegenerator

Dekont

Varsayılan olarak yüklenecek .NET ikili dosyalarının mimarisi şu anda çalışan işletim sistemi mimarisini temsil eder. Farklı bir işletim sistemi mimarisi belirtmek için bkz . dotnet tool install, --arch option. Daha fazla bilgi için bkz. GitHub sorunu dotnet/AspNetCore.Docs #29262.

Aşağıdaki komut, yüklü .NET Core SDK'larından kullanılabilen en son kararlı sürüme güncelleştirilir dotnet aspnet-codegenerator :

dotnet tool update -g dotnet-aspnet-codegenerator

aspnet-codegenerator'ı kaldırma

Sorunları çözmek için öğesinin aspnet-codegenerator kaldırılması gerekebilir. Örneğin, sürümünün aspnet-codegeneratorönizleme sürümünü yüklediyseniz, yayınlanmış sürümü yüklemeden önce sürümünü kaldırın.

Aşağıdaki komutlar aracı kaldırır dotnet aspnet-codegenerator ve en son kararlı sürümü yükler:

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

Özet

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]

Tanım

Genel dotnet aspnet-codegenerator komut, ASP.NET Core kod oluşturucusunu ve iskele altyapısını çalıştırır.

Bağımsız değişkenler

generator

Çalıştırılacak kod oluşturucu. Aşağıdaki oluşturucular kullanılabilir:

Oluşturucu İşlem
Alan Bir Alanı İskeleler
denetleyici Bir denetleyicinin iskelelerini oluşturur
kimlik İskeleler Identity
razorpage yapı iskeleleri Razor sayfaları
görünüm Bir görünümün iskelelerini oluşturur

Seçenekler

-n|--nuget-package-dir

NuGet paket dizinini belirtir.

-c|--configuration {Debug|Release}

Derleme yapılandırmasını tanımlar. Debug varsayılan değerdir.

-tfm|--target-framework

Kullanılacak Hedef Çerçeve . Örneğin, net46.

-b|--build-base-path

Derleme temel yolu.

-h|--help

Komutu için kısa bir yardım yazdırır.

--no-build

Çalıştırmadan önce projeyi derlemez. Ayrıca bayrağı örtük olarak ayarlar --no-restore .

-p|--project <PATH>

Çalıştırılacak proje dosyasının yolunu belirtir (klasör adı veya tam yol). Belirtilmezse, varsayılan olarak geçerli dizine geçer.

Oluşturucu seçenekleri

Aşağıdaki bölümlerde desteklenen oluşturucular için sağlanan seçenekler ayrıntılı olarak açıklanmıştır:

  • Area
  • Oyun kumandası
  • Identity
  • RazorSayfası
  • Göster

Alan seçenekleri

Bu araç, denetleyiciler ve görünümler içeren ASP.NET Core web projeleri için tasarlanmıştır. Sayfalar uygulamaları için Razor tasarlanmamıştır.

Kullanım: dotnet aspnet-codegenerator area AreaNameToGenerate

Yukarıdaki komut aşağıdaki klasörleri oluşturur:

  • Alanlar
    • AreaNameToGenerate
      • Denetleyiciler
      • Veri
      • Modeller
      • Görünümler

Denetleyici seçenekleri

Aşağıdaki tabloda , controller ve viewseçenekleri aspnet-codegeneratorrazorpagelistelenmiştir:

Seçenek Tanım
--model veya -m Kullanılacak model sınıfı.
--dataContext veya -dc DbContext Kullanılacak sınıf veya oluşturulacak sınıfın adı.
--bootstrapVersion veya -b Bootstrap sürümünü belirtir. Geçerli değerler 3 veya 4 şeklindedir. Varsayılan 4 değeridir. Gerekirse ve yoksa, belirtilen sürümün bootstrap dosyalarını içeren bir wwwroot dizini oluşturulur.
--referenceScriptLibraries veya -scripts Oluşturulan görünümlerde başvuru betiği kitaplıkları. Düzenleme ve Oluşturma sayfalarına ekler _ValidationScriptsPartial .
--layout veya -l Kullanılacak özel Düzen sayfası.
--useDefaultLayout veya -udl Görünümler için varsayılan düzeni kullanın.
--force veya -f Varolan dosyaların üzerine yaz.
--relativeFolderPath veya -outDir Dosyanın oluşturulması gereken projeden göreli çıkış klasörü yolunu belirtin; belirtilmezse, dosya proje klasöründe oluşturulacak
--useSqlite veya -sqlite SQL Server yerine SQLite kullanıp kullanmayacağını DbContext belirtmek için bayrak.

Aşağıdaki tabloda, için aspnet-codegenerator controllerbenzersiz seçenekler listelenmiştir:

Seçenek Tanım
--controllerName veya -name Denetleyicinin adı.
--useAsyncActions veya -async Zaman uyumsuz denetleyici eylemleri oluşturun.
--noViews veya -nv Görünüm oluşturma.
--restWithNoViews veya -api Stil API'siyle REST bir Denetleyici oluşturun. noViews varsayılır ve görünümle ilgili seçenekler yoksayılır.
--readWriteActions veya -actions Model olmadan okuma/yazma eylemleriyle denetleyici oluşturma.

Komutta -haspnet-codegenerator controller yardım için anahtarını kullanın:

dotnet aspnet-codegenerator controller -h

Örneği için bkz . Film modelinin iskelesini oluşturma dotnet aspnet-codegenerator controller.

RazorSayfası

Razor Sayfalar, yeni sayfanın adı ve kullanılacak şablon belirtilerek tek tek yapı iskelesi oluşturulabilir. Desteklenen şablonlar şunlardır:

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

Örneğin, aşağıdaki komut ve MyEdit.cshtml.csoluşturmak MyEdit.cshtml için Düzenleme şablonunu kullanır:

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

Genellikle şablon ve oluşturulan dosya adı belirtilmez ve aşağıdaki şablonlar oluşturulur:

  • Create
  • Edit
  • Delete
  • Details
  • List

Aşağıdaki tabloda , controller ve viewseçenekleri aspnet-codegeneratorrazorpagelistelenmiştir:

Seçenek Tanım
--model veya -m Kullanılacak model sınıfı.
--dataContext veya -dc DbContext Kullanılacak sınıf veya oluşturulacak sınıfın adı.
--bootstrapVersion veya -b Bootstrap sürümünü belirtir. Geçerli değerler 3 veya 4 şeklindedir. Varsayılan 4 değeridir. Gerekirse ve yoksa, belirtilen sürümün bootstrap dosyalarını içeren bir wwwroot dizini oluşturulur.
--referenceScriptLibraries veya -scripts Oluşturulan görünümlerde başvuru betiği kitaplıkları. Düzenleme ve Oluşturma sayfalarına ekler _ValidationScriptsPartial .
--layout veya -l Kullanılacak özel Düzen sayfası.
--useDefaultLayout veya -udl Görünümler için varsayılan düzeni kullanın.
--force veya -f Varolan dosyaların üzerine yaz.
--relativeFolderPath veya -outDir Dosyanın oluşturulması gereken projeden göreli çıkış klasörü yolunu belirtin; belirtilmezse, dosya proje klasöründe oluşturulacak
--useSqlite veya -sqlite SQL Server yerine SQLite kullanıp kullanmayacağını DbContext belirtmek için bayrak.

Aşağıdaki tabloda, için aspnet-codegenerator razorpagebenzersiz seçenekler listelenmiştir:

Seçenek Tanım
--namespaceName veya -namespace Oluşturulan PageModel için kullanılacak ad alanının adı
--partialView veya -partial Kısmi bir görünüm oluşturun. Bu belirtilirse düzen seçenekleri -l ve -udl yoksayılır.
--noPageModel veya -npm Boş şablon için PageModel sınıfı oluşturmamaya geçiş yapma

Komutta -haspnet-codegenerator razorpage yardım için anahtarını kullanın:

dotnet aspnet-codegenerator razorpage -h

Örneği için bkz . Film modelinin iskelesini oluşturma dotnet aspnet-codegenerator razorpage.

Göster

Görünümler, görünümün adı ve kullanılacak şablon belirtilerek tek tek yapı iskelesi oluşturulabilir. Desteklenen şablonlar şunlardır:

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

Örneğin, aşağıdaki komut oluşturmak MyEdit.cshtmliçin Düzenleme şablonunu kullanır:

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

Aşağıdaki tabloda , controller ve viewseçenekleri aspnet-codegeneratorrazorpagelistelenmiştir:

Seçenek Tanım
--model veya -m Kullanılacak model sınıfı.
--dataContext veya -dc DbContext Kullanılacak sınıf veya oluşturulacak sınıfın adı.
--bootstrapVersion veya -b Bootstrap sürümünü belirtir. Geçerli değerler 3 veya 4 şeklindedir. Varsayılan 4 değeridir. Gerekirse ve yoksa, belirtilen sürümün bootstrap dosyalarını içeren bir wwwroot dizini oluşturulur.
--referenceScriptLibraries veya -scripts Oluşturulan görünümlerde başvuru betiği kitaplıkları. Düzenleme ve Oluşturma sayfalarına ekler _ValidationScriptsPartial .
--layout veya -l Kullanılacak özel Düzen sayfası.
--useDefaultLayout veya -udl Görünümler için varsayılan düzeni kullanın.
--force veya -f Varolan dosyaların üzerine yaz.
--relativeFolderPath veya -outDir Dosyanın oluşturulması gereken projeden göreli çıkış klasörü yolunu belirtin; belirtilmezse, dosya proje klasöründe oluşturulacak
--useSqlite veya -sqlite SQL Server yerine SQLite kullanıp kullanmayacağını DbContext belirtmek için bayrak.

Aşağıdaki tabloda, için aspnet-codegenerator viewbenzersiz seçenekler listelenmiştir:

Seçenek Tanım
--controllerNamespace veya -namespace Oluşturulan denetleyici için kullanılacak ad alanının adını belirtin
--partialView veya -partial Kısmi görünüm oluşturursanız, bu belirtilirse diğer düzen seçenekleri (-l ve -udl) yoksayılır

Komutta -haspnet-codegenerator view yardım için anahtarını kullanın:

dotnet aspnet-codegenerator view -h

Identity

Bkz. İskele Identity