ASP.NET Core kódgenerátor eszköz (aspnet-codegenerator)

A dotnet aspnet-codegenerator parancs futtatja a ASP.NET Core állványozó motort. A dotnet aspnet-codegenerator parancs futtatása szükséges a scaffold létrehozásához a parancssorból vagy a Visual Studio Code használatakor. A parancs nem szükséges az állványzat használatához a Visual Studióval, amely alapértelmezés szerint tartalmazza az állványzatmotort.

A kódgenerátor eszköz telepítése és frissítése

Telepítse a .NET SDK.

dotnet aspnet-codegenerator egy globális eszköz, amelyet telepíteni kell. A következő parancs telepíti a ASP.NET Core kódgenerátor eszköz legújabb stabil verzióját:

dotnet tool install -g dotnet-aspnet-codegenerator

Note

Alapértelmezés szerint a telepíteni kívánt .NET bináris fájlok architektúrája a jelenleg futó operációsrendszer-architektúrát jelöli. Ha másik operációsrendszer-architektúrát szeretne megadni, tekintse meg dotnet eszköz telepítését, az --arch lehetőséget. További információ: GitHub-probléma dotnet/AspNetCore.Docs #29262.

Ha az eszköz már telepítve van, a következő parancs frissíti az eszközt a telepített .NET SDK-kból elérhető legújabb stabil verzióra:

dotnet tool update -g dotnet-aspnet-codegenerator

A kódgenerátor eszköz eltávolítása

A problémák megoldásához szükség lehet a ASP.NET Core kódgenerátor eszköz eltávolítására. Ha például telepítette az eszköz előzetes verzióját, távolítsa el azt a kiadott verzió telepítése előtt.

Az alábbi parancsok eltávolítják a ASP.NET Core kódgenerátor eszközt, és telepítik a legújabb stabil verziót:

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

Synopsis

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

Description

A dotnet aspnet-codegenerator globális parancs futtatja a ASP.NET Core kódgenerátort és az állványzatmotort.

Arguments

generator

A futtatandó kódgenerátor. A rendelkezésre álló generátorok az alábbi táblázatban láthatók.

Generator	Operation
area	Állványoz egy területet.
blazor	Sablonok Blazor létrehoz, olvas, frissít, töröl és listáz lapokat.
blazor-identity	Blazor Identity fájlokat hoz létre.
controller	vezérlő alapvázát hozza létre.
identity	állványok Identity.
minimalapi	Létrehoz egy végpontfájlt (CRUD API-végpontokkal) egy modell és egy opcionális adatbázis-környezet alapján.
razorpage	Állványok Razor Lapok.
view	Keretrendszer nézetet biztosít.

Beállítások

-b|--build-base-path

A build alapútvonala.

-c|--configuration {Debug|Release}

Meghatározza a buildkonfigurációt. Az alapértelmezett érték a Debug.

-h|--help

Kinyomtat egy rövid súgót a parancshoz.

-n|--nuget-package-dir

Megadja a NuGet-csomag könyvtárát.

--no-build

Futtatás előtt nem hozza létre a projektet. A --no-build kifejezés implicit módon beállítja a --no-restore jelzőt is.

-p|--project <PATH>

Megadja a futtatni kívánt projektfájl elérési útját (mappanév vagy teljes elérési út). Ha nincs megadva, az eszköz alapértelmezés szerint az aktuális könyvtárba lesz bekapcsolva.

-tfm|--target-framework

A használni kívánt cél-keretrendszer.

Generátor beállításai

A következő szakaszok a támogatott generátorok számára elérhető lehetőségeket ismertetik:

• terület (area)
• vezérlő (controller)
• Blazor (blazor)
• Blazor Identity (blazor-identity)
• Identity (identity)
• Minimális API (minimalapi)
• Razor lap (razorpage)
• Nézet (view)

Területbeállítások

Használat: dotnet aspnet-codegenerator area {AREA NAME}

A {AREA NAME} helyfoglaló a létrehozandó terület neve.

Az előző parancs a következő mappákat hozza létre:

• Areas
  • {AREA NAME}
    • Controllers
    • Data
    • Models
    • Views

Segítségért használja a -h|--help lehetőséget:

dotnet aspnet-codegenerator area -h

Blazor beállítások

Razor összetevők külön-külön állíthatók össze Blazor alkalmazásokhoz a használandó sablon nevének megadásával. A támogatott sablonok a következők:

• Empty
• Create
• Edit
• Delete
• Details
• List
• CRUD: CRUD a létrehozás, olvasás, frissítés és törlés rövidítése. A CRUD sablon Create, Edit, Delete, Detailsés Index (List) összetevőket állít elő az alkalmazáshoz.

A blazor generátor beállításai az alábbi táblázatban láthatók.

Option	Description
-dbProvider|--databaseProvider	Használandó adatbázis-szolgáltató. A beállítások közé tartozik az sqlserver (alapértelmezett), sqlite, cosmosvagy postgres.
-dc|--dataContext	Használandó adatbázis-környezeti osztály.
-m|--model	Használandó modellosztály.
-ns|--namespaceName	Adja meg a létrehozott Végpontok fájlhoz használandó névtér nevét.
--relativeFolderPath|-outDir	Relatív kimeneti mappa elérési útja. Ha nincs megadva, a rendszer fájlokat hoz létre a projektmappában.

A következő példa:

• A Edit sablonnal létrehoz egy Edit összetevőt (Edit.razor) az alkalmazás Components/Pages/MoviePages mappájában. Ha a MoviePages mappa nem létezik, az eszköz automatikusan létrehozza a mappát.
• Az SQLite adatbázis-szolgáltatót használja.
• Az BlazorWebAppMovies.Data.BlazorWebAppMoviesContext-at használja az adatbázis-környezetben.
• A Movie modellt használja.

dotnet aspnet-codegenerator blazor Edit -dbProvider sqlite -dc BlazorWebAppMovies.Data.BlazorWebAppMoviesContext -m Movie -outDir Components/Pages

Segítségért használja a -h|--help lehetőséget:

dotnet aspnet-codegenerator blazor -h

A blazor generátort használó példáért tekintse meg Blazor filmadatbázis-alkalmazás (Áttekintés)című témakört.

További információ: ASP.NET Core Blazor `QuickGrid` összetevő.

Blazor Identity beállítások

A Identity generátorral építsd be a RazorBlazor összetevőket a blazor-identity alkalmazásba.

A blazor-identity sablon beállításai az alábbi táblázatban láthatók.

Option	Description
-dbProvider|--databaseProvider	Használandó adatbázis-szolgáltató. A beállítások közé tartozik az sqlserver (alapértelmezett) és a sqlite.
-dc|--dataContext	Használandó adatbázis-környezeti osztály.
-f|--force	Ezzel a beállítással felülírhatja a meglévő fájlokat.
-fi|--files	Pontosvesszővel tagolt fájlok listája az állványzathoz. A -lf|--listFiles lehetőséggel megtekintheti az elérhető lehetőségeket.
-lf|--listFiles	Azokat a fájlokat sorolja fel, amelyek az -fi|--files beállítással generálhatók sablonként.
-rn|--rootNamespace	A Identity kód létrehozásához használandó gyökérnévtér.
-u|--userClass	A létrehozandó felhasználói osztály neve.

Segítségért használja a -h|--help lehetőséget:

dotnet aspnet-codegenerator blazor-identity -h

Vezérlő beállításai

Az általános beállítások az alábbi táblázatban láthatók.

Option	Description
-b|--bootstrapVersion	Megadja a bootstrap verzióját, és létrehoz egy wwwroot mappát a Bootstrap-objektumokhoz, ha a mappa nincs jelen.
-dbProvider|--databaseProvider	Használandó adatbázis-szolgáltató. A beállítások közé tartozik az sqlserver (alapértelmezett), sqlite, cosmos, postgres.
-dc|--dataContext	A használni kívánt adatbázis környezeti osztálya vagy a létrehozandó osztály neve.
-f|--force	Meglévő fájlok felülírása.
-l|--layout	Használandó egyéni elrendezési lap.
-m|--model	Használandó modellosztály.
-outDir|--relativeFolderPath	Relatív kimeneti mappa elérési útja. Ha nincs megadva, a rendszer fájlokat hoz létre a projektmappában.
-scripts|--referenceScriptLibraries	Referenciaszkripttárak a létrehozott nézetekben. A(z) _ValidationScriptsPartial hozzáadása a(z) Edit és Create oldalakhoz.
-sqlite|--useSqlite	Jelölő annak megadásához, hogy az adatbázis-környezet az SQL Server helyett SQLite-t használjon-e.
-udl|--useDefaultLayout	Használja a nézetek alapértelmezett elrendezését.

A controller egyedi beállításai az alábbi táblázatban láthatók.

Option	Description
-actions|--readWriteActions	Vezérlő létrehozása modell nélküli olvasási/írási műveletekkel.
-api|--restWithNoViews	Vezérlő létrehozása REST stílusú API-val. noViews feltételezzük, és a nézettel kapcsolatos beállítások figyelmen kívül lesznek hagyva.
-async|--useAsyncActions	Aszinkron vezérlőműveletek létrehozása.
-name|--controllerName	A vezérlő neve.
-namespace|--controllerNamespace	Adja meg a létrehozott vezérlőhöz használandó névtér nevét.
-nv|--noViews	nem nézetek létrehozása.

Segítségért használja a -h|--help lehetőséget:

dotnet aspnet-codegenerator controller -h

A controller generátort használó példáért lásd: 4. rész, modell hozzáadása egy ASP.NET Core MVC-alkalmazáshoz.

Identity beállítások

További információ: Állványzat Identity ASP.NET Core-projektekben.

Minimális API-beállítások

Egy minimális API-háttérrendszert hozhat létre a minimalapi sablonnal.

A minimalapi beállításai az alábbi táblázatban láthatók.

Option	Description
-dbProvider|--databaseProvider	Használandó adatbázis-szolgáltató. A beállítások közé tartozik az sqlserver (alapértelmezett), sqlite, cosmosvagy postgres.
-dc|--dataContext	Használandó adatbázis-környezeti osztály.
-e|--endpoints	Használandó végpontosztály (nem a fájlnév).
-m|--model	Használandó modellosztály.
-namespace|--endpointsNamespace	Adja meg a létrehozott végpontfájlhoz használandó névtér nevét.
-o|--open	Ezzel a beállítással engedélyezheti az OpenAPI-t.
-outDir|--relativeFolderPath	Relatív kimeneti mappa elérési útja. Ha nincs megadva, a rendszer fájlokat hoz létre a projektmappában.
-sqlite|--useSqlite	Jelölő annak megadásához, hogy az adatbázis-környezet az SQL Server helyett SQLite-t használjon-e.

A következő példa:

• Létrehoz egy SpeakersEndpoints nevű végpontosztályt olyan API-végpontokkal, amelyek az adatbázis-műveletekhez megfeleltetik a ApplicationDbContext adatbázis környezeti osztályát és a BackEnd.Models.Speaker modellt.
• Hozzáad app.MapSpeakerEndpoints(); a Program fájlhoz (Program.cs) a végpontosztály regisztrálásához.

dotnet aspnet-codegenerator minimalapi -dc ApplicationDbContext -e SpeakerEndpoints -m BackEnd.Models.Speaker -o

Segítségért használja a -h|--help lehetőséget:

dotnet aspnet-codegenerator minimalapi -h

Razor lapbeállítások

Razor lapok egyedileg állíthatók be az új lap és a használni kívánt sablon nevének megadásával. A támogatott sablonok a következők:

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

A sablon és a létrehozott fájlnév általában nincs megadva, ami a következő sablonokat hozza létre:

• Create
• Edit
• Delete
• Details
• List

Az általános beállítások az alábbi táblázatban láthatók.

Option	Description
-b|--bootstrapVersion	Megadja a bootstrap verzióját, és létrehoz egy wwwroot mappát a Bootstrap-objektumokhoz, ha a mappa nincs jelen.
-dbProvider|--databaseProvider	Használandó adatbázis-szolgáltató. A beállítások közé tartozik az sqlserver (alapértelmezett), sqlite, cosmos, postgres.
-dc|--dataContext	A használni kívánt adatbázis környezeti osztálya vagy a létrehozandó osztály neve.
-f|--force	Meglévő fájlok felülírása.
-l|--layout	Használandó egyéni elrendezési lap.
-m|--model	Használandó modellosztály.
-outDir|--relativeFolderPath	Relatív kimeneti mappa elérési útja. Ha nincs megadva, a rendszer fájlokat hoz létre a projektmappában.
-scripts|--referenceScriptLibraries	Referenciaszkripttárak a létrehozott nézetekben. A(z) _ValidationScriptsPartial hozzáadása a(z) Edit és Create oldalakhoz.
-sqlite|--useSqlite	Jelölő annak megadásához, hogy az adatbázis-környezet az SQL Server helyett SQLite-t használjon-e.
-udl|--useDefaultLayout	Használja a nézetek alapértelmezett elrendezését.

A razorpage egyedi beállításai az alábbi táblázatban láthatók.

Option	Description
-namespace|--namespaceName	A létrehozott PageModel osztályhoz használandó névtér neve.
-npm|--noPageModel	Ne hozzon létre PageModel osztályt a Empty sablonhoz.
-partial|--partialView	Részleges nézet létrehozása. Ha ez meg van adva, az elrendezési beállításokat -l és -udl figyelmen kívül hagyja a rendszer.

Az alábbi példa a Edit sablon használatával hoz létre CustomEditPage.cshtml és CustomEditPage.cshtml.cs a Pages/Movies mappában:

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

Segítségért használja a -h|--help lehetőséget:

dotnet aspnet-codegenerator razorpage -h

A razorpage generátort használó példáért lásd a 2. részt, a modellbeillesztésével.

Megtekintési beállítások

A nézetek egyedileg strukturálhatók a nézet és a sablon nevének megadásával. A támogatott sablonok a következők:

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

Az általános beállítások az alábbi táblázatban láthatók.

Option	Description
-b|--bootstrapVersion	Megadja a bootstrap verzióját, és létrehoz egy wwwroot mappát a Bootstrap-objektumokhoz, ha a mappa nincs jelen.
-dbProvider|--databaseProvider	Használandó adatbázis-szolgáltató. A beállítások közé tartozik az sqlserver (alapértelmezett), sqlite, cosmos, postgres.
-dc|--dataContext	A használni kívánt adatbázis környezeti osztálya vagy a létrehozandó osztály neve.
-f|--force	Meglévő fájlok felülírása.
-l|--layout	Használandó egyéni elrendezési lap.
-m|--model	Használandó modellosztály.
-outDir|--relativeFolderPath	Relatív kimeneti mappa elérési útja. Ha nincs megadva, a rendszer fájlokat hoz létre a projektmappában.
-scripts|--referenceScriptLibraries	Referenciaszkripttárak a létrehozott nézetekben. A(z) _ValidationScriptsPartial hozzáadása a(z) Edit és Create oldalakhoz.
-sqlite|--useSqlite	Jelölő annak megadásához, hogy az adatbázis-környezet az SQL Server helyett SQLite-t használjon-e.
-udl|--useDefaultLayout	Használja a nézetek alapértelmezett elrendezését.

A view egyedi beállításai az alábbi táblázatban láthatók.

Option	Description
-namespace|--controllerNamespace	Adja meg a létrehozott vezérlőhöz használandó névtér nevét.
-partial|--partialView	Részleges nézet létrehozása. Ha ez meg van adva, az egyéb elrendezési beállítások (-l és -udl) figyelmen kívül lesznek hagyva.

Az alábbi példa a Edit sablon használatával hoz létre CustomEditView.cshtml a Views/Movies mappában:

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

Segítségért használja a -h|--help lehetőséget:

dotnet aspnet-codegenerator view -h