dotnet-aspnet-codegenerator
Autor: Rick Anderson
dotnet-aspnet-codegenerator– Spustí ASP.NET Core generování uživatelského rozhraní. dotnet-aspnet-codegeneratorse vyžaduje pouze pro generování uživatelského rozhraní z příkazového řádku, není nutné používat generování uživatelského rozhraní s Visual Studio.
Instalace a aktualizace nástroje aspnet-codegenerator
Nainstalujte sadu .NET SDK.
dotnet-aspnet-codegenerator je 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
Následující příkaz aktualizuje na dotnet-aspnet-codegenerator nejnovější stabilní verzi dostupnou z nainstalovaných .NET Core SDK:
dotnet tool update -g dotnet-aspnet-codegenerator
Odinstalace nástroje aspnet-codegenerator
K vyřešení problémů může být potřeba aspnet-codegenerator odinstalovat . Pokud jste například nainstalovali verzi Preview aspnet-codegenerator nástroje , odinstalujte ji před instalací vydané verze.
Následující příkazy nástroj dotnet-aspnet-codegenerator odinstaluje 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 ASP.NET Core kódu a generátor kódu.
Argumenty
generator
Generátor kódu, který se má spustit. K dispozici jsou následující generátory:
| Generátor | Operace |
|---|---|
| oblast | Generování uživatelského rozhraní oblasti |
| kontroler | Generování uživatelského rozhraní kontroleru |
| identity | Lešení Identity |
| razorpage | Stránky generování Razor uživatelského rozhraní |
| Prohlédni | Generování uživatelského rozhraní zobrazení |
Možnosti
-n|--nuget-package-dir
Určuje adresář NuGet balíčku.
-c|--configuration {Debug|Release}
Definuje konfiguraci sestavení. Výchozí hodnota je Debug.
-tfm|--target-framework
Cílová rozhraní, která se má použít. Například, net46.
-b|--build-base-path
Základní cesta sestavení.
-h|--help
Vytiskne krátkou nápovědu k příkazu .
--no-build
Nevytváří projekt před spuštěním. Příznak také implicitně --no-restore nastavuje.
-p|--project <PATH>
Určuje cestu ke spuštění souboru projektu (název složky nebo úplná cesta). Pokud není zadaný, výchozí hodnota je aktuální adresář.
Možnosti generátoru
Následující části podrobně popisují možnosti dostupné pro podporované generátory:
- Plošný
- Controller
- Identity
- RazorStránka
- Zobrazení
Možnosti oblasti
Tento nástroj je určený pro ASP.NET Core webových projektů s kontrolery a zobrazeními. Není určený pro aplikace Razor Pages.
Použití: dotnet-aspnet-codegenerator area AreaNameToGenerate
Předchozí příkaz vygeneruje následující složky:
- Oblasti
- AreaNameToGenerate
- Kontrolery
- Data
- Modely
- Zobrazení
- AreaNameToGenerate
Možnosti kontroleru
Následující tabulka uvádí možnosti pro , a aspnet-codegenerator razorpage controller view :
| Možnost | Popis |
|---|---|
| --model nebo -m | Třída modelu, 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í je 4. Pokud je to potřeba a není k dispozici, vytvoří se adresář wwwroot, který obsahuje spouštěcí soubory zadané verze. |
| --referenceScriptLibraries nebo -scripts | Referenční knihovny skriptů ve generovaných zobrazeních. Přidá _ValidationScriptsPartial na stránky Upravit a Vytvořit. |
| --layout nebo -l | Stránka s vlastním rozložením, která se má použít. |
| --useDefaultLayout nebo -udl | Pro zobrazení použijte výchozí rozložení. |
| --force nebo -f | Přepsat existující soubory. |
| --relativeFolderPath nebo -outDir | Zadejte relativní cestu k výstupní složce z projektu, ve které se má soubor vygenerovat. Pokud není zadaný, vygeneruje se soubor ve složce projektu. |
| --useSqlite nebo -sqlite | Příznak, který určuje, jestli se DbContext má místo SQL Server použít sqlite. |
Následující tabulka uvádí možnosti jedinečné pro aspnet-codegenerator controller :
| Možnost | Popis |
|---|---|
| --controllerName nebo -name | Název kontroleru. |
| --useAsyncActions nebo -async | Generování asynchronních akcí kontroleru |
| --noViews nebo -nv | Negeneruje žádná zobrazení. |
| --restWithNoViews nebo -api | Vygenerování kontroleru pomocí rozhraní REST API ve stylu noViews se předpokládá a všechny možnosti související s zobrazením se ignorují. |
| --readWriteActions nebo -actions | Generování kontroleru s akcemi čtení a zápisu bez modelu |
Nápovědu -h k příkazu zobrazíte pomocí přepínače aspnet-codegenerator controller :
dotnet-aspnet-codegenerator controller -h
Příklad najdete v části Scaffold the movie model (Vymodelovat filmový dotnet-aspnet-codegenerator controller model).
RazorStránka
Razor Stránky je možné jednotlivě vytvořit tak, že zadáte název nové stránky a šablonu, která se má použít. Podporované šablony jsou:
EmptyCreateEditDeleteDetailsList
Následující příkaz například pomocí šablony Edit vygeneruje soubory MyEdit.cshtml a MyEdit.cshtml.cs:
dotnet-aspnet-codegenerator razorpage MyEdit Edit -m Movie -dc RazorPagesMovieContext -outDir Pages/Movies
Šablona a vygenerovaný název souboru se obvykle nezadá a vytvoří se následující šablony:
CreateEditDeleteDetailsList
Následující tabulka uvádí možnosti pro , a aspnet-codegenerator razorpage controller view :
| Možnost | Popis |
|---|---|
| --model nebo -m | Třída modelu, 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í je 4. Pokud je to potřeba a není k dispozici, vytvoří se adresář wwwroot, který obsahuje spouštěcí soubory zadané verze. |
| --referenceScriptLibraries nebo -scripts | Referenční knihovny skriptů ve generovaných zobrazeních. Přidá _ValidationScriptsPartial na stránky Upravit a Vytvořit. |
| --layout nebo -l | Stránka s vlastním rozložením, která se má použít. |
| --useDefaultLayout nebo -udl | Pro zobrazení použijte výchozí rozložení. |
| --force nebo -f | Přepsat existující soubory. |
| --relativeFolderPath nebo -outDir | Zadejte relativní cestu k výstupní složce z projektu, ve které se má soubor vygenerovat. Pokud není zadaný, vygeneruje se soubor ve složce projektu. |
| --useSqlite nebo -sqlite | Příznak, který určuje, jestli se DbContext má místo SQL Server použít sqlite. |
Následující tabulka uvádí možnosti jedinečné pro aspnet-codegenerator razorpage :
| Možnost | Popis |
|---|---|
| --namespaceName nebo -namespace | Název oboru názvů, který se má použít pro vygenerovaný model PageModel |
| --partialView nebo -partial | Vygenerování částečného zobrazení Pokud je tento parametr zadaný, možnosti rozložení -l a -udl se ignorují. |
| --noPageModel nebo -npm | Přepnutí na nevygenerování třídy PageModel pro prázdnou šablonu |
Nápovědu -h k příkazu zobrazíte pomocí přepínače aspnet-codegenerator razorpage :
dotnet-aspnet-codegenerator razorpage -h
Příklad najdete v části Scaffold the movie model (Vymodelovat filmový dotnet-aspnet-codegenerator razorpage model).
Zobrazení
Zobrazení lze jednotlivě vytvořit tak, že zadáte název zobrazení a šablonu, která se má použít. Podporované šablony jsou:
EmptyCreateEditDeleteDetailsList
Například následující příkaz používá šablonu Edit k vygenerování souboru MyEdit.cshtml:
dotnet-aspnet-codegenerator view MyEdit Edit -m Movie -dc MovieContext -outDir Views/Movies
Následující tabulka uvádí možnosti pro , a aspnet-codegenerator razorpage controller view :
| Možnost | Popis |
|---|---|
| --model nebo -m | Třída modelu, 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í je 4. Pokud je to potřeba a není k dispozici, vytvoří se adresář wwwroot, který obsahuje spouštěcí soubory zadané verze. |
| --referenceScriptLibraries nebo -scripts | Referenční knihovny skriptů ve generovaných zobrazeních. Přidá _ValidationScriptsPartial na stránky Upravit a Vytvořit. |
| --layout nebo -l | Stránka s vlastním rozložením, která se má použít. |
| --useDefaultLayout nebo -udl | Pro zobrazení použijte výchozí rozložení. |
| --force nebo -f | Přepsat existující soubory. |
| --relativeFolderPath nebo -outDir | Zadejte relativní cestu k výstupní složce z projektu, ve které se má soubor vygenerovat. Pokud není zadaný, vygeneruje se soubor ve složce projektu. |
| --useSqlite nebo -sqlite | Příznak, který určuje, jestli se DbContext má místo SQL Server použít sqlite. |
Následující tabulka uvádí možnosti 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 | Při generování částečného zobrazení se ostatní možnosti rozložení (-l a -udl) ignorují, pokud je toto nastavení zadané. |
Nápovědu -h k příkazu zobrazíte pomocí přepínače aspnet-codegenerator view :
dotnet-aspnet-codegenerator view -h