dotnet aspnet-codegenerator

Autor: Rick Anderson

dotnet aspnet-codegenerator – Spustí modul generování uživatelského rozhraní ASP.NET Core. dotnet aspnet-codegenerator se vyžaduje pouze k generování uživatelského rozhraní z příkazového řádku, není nutné používat generování uživatelského rozhraní se sadou Visual Studio.

Instalace a aktualizace aspnet-codegeneratoru

Nainstalujte sadu .NET SDK.

dotnet aspnet-codegeneratorje globální nástroj, který se musí nainstalovat. Následující příkaz nainstaluje nejnovější stabilní verzi dotnet aspnet-codegenerator nástroje:

dotnet tool install -g dotnet-aspnet-codegenerator

Poznámka

Ve výchozím nastavení architektura binárních souborů .NET, které se mají nainstalovat, představuje aktuálně spuštěnou architekturu operačního systému. Pokud chcete zadat jinou architekturu operačního systému, přečtěte si téma instalace nástroje dotnet, možnost --arch. Další informace najdete v tématu o problému GitHubu dotnet/AspNetCore.Docs #29262.

Následující příkaz aktualizuje dotnet aspnet-codegenerator nejnovější stabilní verzi dostupnou z nainstalovaných sad .NET Core SDK:

dotnet tool update -g dotnet-aspnet-codegenerator

Odinstalace aspnet-codegeneratoru

Možná bude nutné odinstalovat aspnet-codegenerator řešení problémů. Pokud jste například nainstalovali verzi aspnet-codegeneratorPreview , odinstalujte ji před instalací vydané verze.

Následující příkazy nástroj odinstalují dotnet aspnet-codegenerator a nainstalují nejnovější stabilní verzi:

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

Synopse

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]

Popis

Globální dotnet aspnet-codegenerator příkaz spustí generátor kódu ASP.NET Core a modul generování uživatelského rozhraní.

Argumenty

generator

Generátor kódu, který se má spustit. K dispozici jsou následující generátory:

Generátor Operace
Oblasti Vygeneruje oblast.
kontroler Vygeneruje kontroler.
identita Lešení Identity
razorpage Stránky uživatelského rozhraní Razor
zobrazit Generování uživatelského rozhraní zobrazení

Možnosti

-n|--nuget-package-dir

Určuje adresář balíčku NuGet.

-c|--configuration {Debug|Release}

Definuje konfiguraci sestavení. Výchozí hodnota je Debug.

-tfm|--target-framework

Cílová architektura , která se má použít. Například, net46.

-b|--build-base-path

Základní cesta sestavení.

-h|--help

Vytiskne krátkou nápovědu pro příkaz.

--no-build

Nevystaví projekt před spuštěním. Příznak také implicitně nastaví --no-restore .

-p|--project <PATH>

Určuje cestu ke spuštění souboru projektu (název složky nebo úplná cesta). Pokud není zadaný, nastaví se jako výchozí aktuální adresář.

Možnosti generátoru

Následující části obsahují podrobnosti o možnostech dostupných pro podporované generátory:

  • Plocha
  • Ovladač
  • Identity
  • RazorStránka
  • Zobrazení

Možnosti oblasti

Tento nástroj je určený pro webové projekty ASP.NET Core s řadiči a zobrazeními. Není určená pro Razor aplikace Pages.

Použití: dotnet aspnet-codegenerator area AreaNameToGenerate

Předchozí příkaz vygeneruje následující složky:

  • Oblasti
    • AreaNameToGenerate
      • Kontrolery
      • Data
      • Modely
      • Zobrazení

Možnosti kontroleru

V následující tabulce jsou uvedeny možnosti pro aspnet-codegeneratorrazorpage: controllerview

Možnost Popis
--model nebo -m Modelová třída, která se má použít.
--dataContext nebo -dc Třída DbContext , která se má použít, nebo název třídy, která se má vygenerovat.
--bootstrapVersion nebo -b Určuje verzi bootstrap. Platné hodnoty jsou 3 nebo 4. Výchozí hodnota je 4. V případě potřeby a není k dispozici, vytvoří se adresář wwwroot , který obsahuje soubory bootstrap zadané verze.
--referenceScriptLibraries nebo -scripts Referenční knihovny skriptů ve vygenerovaných zobrazeních Přidá _ValidationScriptsPartial stránky pro úpravy a vytváření.
--layout nebo -l Stránka Vlastní rozložení, která se má použít
--useDefaultLayout nebo -udl Pro zobrazení použijte výchozí rozložení.
--force nebo -f Přepište existující soubory.
--relativeFolderPath nebo -outDir Zadejte relativní cestu k výstupní složce z projektu, kde se soubor musí vygenerovat, pokud není zadaný, soubor se vygeneruje ve složce projektu.
--useSqlite nebo -sqlite Příznak, který určuje, jestli DbContext má místo SQL Serveru používat SQLite.

Následující tabulka uvádí možnosti, které jsou jedinečné pro aspnet-codegenerator controller:

Možnost Popis
--controllerName nebo -name Název kontroleru.
--useAsyncActions nebo -async Vygenerujte akce asynchronního kontroleru.
--noViews nebo -nv Generování žádných zobrazení
--restWithNoViews nebo -api Generování kontroleru pomocí REST rozhraní API stylu noViews se předpokládá a všechny možnosti související se zobrazením se ignorují.
--readWriteActions nebo -actions Vygenerujte kontroler s akcemi čtení a zápisu bez modelu.

-h Použijte přepínač pro nápovědu k aspnet-codegenerator controller příkazu:

dotnet aspnet-codegenerator controller -h

Podívejte se na vygenerování modelu filmu, například dotnet aspnet-codegenerator controller.

RazorStránka

Razor Stránky lze jednotlivě vygenerovat zadáním názvu nové stránky a šablony, kterou chcete použít. Mezi podporované šablony patří:

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

Například následující příkaz používá šablonu Upravit k vygenerování MyEdit.cshtml a MyEdit.cshtml.cs:

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

Obvykle není zadán název šablony a vygenerovaného souboru a vytvoří se následující šablony:

  • Create
  • Edit
  • Delete
  • Details
  • List

V následující tabulce jsou uvedeny možnosti pro aspnet-codegeneratorrazorpage: controllerview

Možnost Popis
--model nebo -m Modelová třída, která se má použít.
--dataContext nebo -dc Třída DbContext , která se má použít, nebo název třídy, která se má vygenerovat.
--bootstrapVersion nebo -b Určuje verzi bootstrap. Platné hodnoty jsou 3 nebo 4. Výchozí hodnota je 4. V případě potřeby a není k dispozici, vytvoří se adresář wwwroot , který obsahuje soubory bootstrap zadané verze.
--referenceScriptLibraries nebo -scripts Referenční knihovny skriptů ve vygenerovaných zobrazeních Přidá _ValidationScriptsPartial stránky pro úpravy a vytváření.
--layout nebo -l Stránka Vlastní rozložení, která se má použít
--useDefaultLayout nebo -udl Pro zobrazení použijte výchozí rozložení.
--force nebo -f Přepište existující soubory.
--relativeFolderPath nebo -outDir Zadejte relativní cestu k výstupní složce z projektu, kde se soubor musí vygenerovat, pokud není zadaný, soubor se vygeneruje ve složce projektu.
--useSqlite nebo -sqlite Příznak, který určuje, jestli DbContext má místo SQL Serveru používat SQLite.

Následující tabulka uvádí možnosti, které jsou jedinečné pro aspnet-codegenerator razorpage:

Možnost Popis
--namespaceName nebo -namespace Název oboru názvů, který se má použít pro vygenerovaný PageModel
--partialView nebo -partial Vygenerujte částečné zobrazení. Možnosti rozložení -l a -udl se při zadání ignorují.
--noPageModel nebo -npm Přepnutí na negenerování třídy PageModel pro prázdnou šablonu

-h Použijte přepínač pro nápovědu k aspnet-codegenerator razorpage příkazu:

dotnet aspnet-codegenerator razorpage -h

Podívejte se na vygenerování modelu filmu, například dotnet aspnet-codegenerator razorpage.

Zobrazení

Zobrazení lze jednotlivě vygenerovat zadáním názvu zobrazení a šablony, která se má použít. Mezi podporované šablony patří:

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

Například následující příkaz používá k vygenerování MyEdit.cshtmlšablonu Upravit:

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

V následující tabulce jsou uvedeny možnosti pro aspnet-codegeneratorrazorpage: controllerview

Možnost Popis
--model nebo -m Modelová třída, která se má použít.
--dataContext nebo -dc Třída DbContext , která se má použít, nebo název třídy, která se má vygenerovat.
--bootstrapVersion nebo -b Určuje verzi bootstrap. Platné hodnoty jsou 3 nebo 4. Výchozí hodnota je 4. V případě potřeby a není k dispozici, vytvoří se adresář wwwroot , který obsahuje soubory bootstrap zadané verze.
--referenceScriptLibraries nebo -scripts Referenční knihovny skriptů ve vygenerovaných zobrazeních Přidá _ValidationScriptsPartial stránky pro úpravy a vytváření.
--layout nebo -l Stránka Vlastní rozložení, která se má použít
--useDefaultLayout nebo -udl Pro zobrazení použijte výchozí rozložení.
--force nebo -f Přepište existující soubory.
--relativeFolderPath nebo -outDir Zadejte relativní cestu k výstupní složce z projektu, kde se soubor musí vygenerovat, pokud není zadaný, soubor se vygeneruje ve složce projektu.
--useSqlite nebo -sqlite Příznak, který určuje, jestli DbContext má místo SQL Serveru používat SQLite.

Následující tabulka uvádí možnosti, které jsou jedinečné pro aspnet-codegenerator view:

Možnost Popis
--controllerNamespace nebo -namespace Zadejte název oboru názvů, který se má použít pro vygenerovaný kontroler.
--partialView nebo -partial Vygenerování částečného zobrazení, ostatní možnosti rozložení (-l a -udl) se při zadání ignorují.

-h Použijte přepínač pro nápovědu k aspnet-codegenerator view příkazu:

dotnet aspnet-codegenerator view -h

Identity

Viz generování uživatelského rozhraní Identity