dotnet új <SABLON>
Ez a cikk a következőre vonatkozik: ✔️ .NET Core 3.1 SDK és újabb verziók
Név
dotnet new
– Létrehoz egy új projektet, konfigurációs fájlt vagy megoldást a megadott sablon alapján.
Szinopszis
dotnet new <TEMPLATE> [--dry-run] [--force] [-lang|--language {"C#"|"F#"|VB}]
[-n|--name <OUTPUT_NAME>] [-f|--framework <FRAMEWORK>] [--no-update-check]
[-o|--output <OUTPUT_DIRECTORY>] [--project <PROJECT_PATH>]
[-d|--diagnostics] [--verbosity <LEVEL>] [Template options]
dotnet new -h|--help
Leírás
A dotnet new
parancs .NET-projektet vagy más összetevőket hoz létre sablon alapján.
A parancs meghívja a sablonmotort , hogy a megadott sablon és beállítások alapján hozza létre az összetevőket a lemezen.
Feljegyzés
A .NET 7 SDK-tól kezdve a dotnet new
szintaxis megváltozott:
- A
--list
,--search
,--install
és--uninstall
a lehetőségek letteklist
,search
ésinstall
uninstall
alparancsok. - A
--update-apply
lehetőség lett azupdate
alparancs. - A használatához
--update-check
használja azupdate
alparancsot a--check-only
beállítással.
A korábban elérhető egyéb lehetőségek továbbra is használhatók a megfelelő alparancsokkal.
Az egyes alparancsokhoz külön súgó érhető el az -h
alparancson --help
keresztül: dotnet new <subcommand> --help
felsorolja az alparancs összes támogatott beállítását.
Emellett a tabulátorkiegészítés már elérhető a következőhöz dotnet new
: . Támogatja a telepített sablonnevek befejezését, valamint a kiválasztott sablon által biztosított beállításokat.
A .NET SDK lapkiegészítésének aktiválásához lásd: Lapkizárás engedélyezése.
Tabulátor kitöltése
A .NET SDK 7.0.100-tól kezdődően a lapkizárás elérhető a következőhöz dotnet new
: . Támogatja a telepített sablonnevek befejezését, valamint a kiválasztott sablon által biztosított beállítások teljesítését.
A .NET SDK lapkiegészítésének aktiválásához lásd: Lapkizárás engedélyezése.
Implicit visszaállítás
Nem kell futtatnia dotnet restore
, mert implicit módon fut minden olyan parancs, amely visszaállítást igényel, például dotnet new
, dotnet build
, dotnet run
, dotnet test
, dotnet publish
és dotnet pack
. Az implicit visszaállítás letiltásához használja a --no-restore
lehetőséget.
A dotnet restore
parancs továbbra is hasznos bizonyos esetekben, amikor a explicit visszaállításnak van értelme, például folyamatos integrációs buildek az Azure DevOps Servicesben vagy olyan buildrendszerekben, amelyeknek explicit módon kell szabályozni a visszaállítást.
A NuGet-hírcsatornák kezelésével kapcsolatos információkért tekintse meg a dokumentációtdotnet restore
.
Argumentumok
TEMPLATE
A parancs meghívásakor példányosítandó sablon. Előfordulhat, hogy minden sablon adott lehetőségeket ad át. További információ: Sablonbeállítások.
Az összes telepített sablon listájának megtekintéséhez futhat
dotnet new list
.A .NET Core 3.0 SDK-tól kezdve és a .NET SDK 5.0.300-as verzióval végződő parancssori felület sablonokat keres a NuGet.org, amikor meghívja a
dotnet new
parancsot a következő feltételek szerint:- Ha a parancssori felület nem talál egyező sablont a meghíváskor
dotnet new
, még csak nem is részleges. - Ha a sablon egy újabb verziója érhető el. Ebben az esetben a projekt vagy összetevő létrejön, de a parancssori felület figyelmezteti a sablon frissített verziójára.
A .NET SDK 5.0.300-as verziótól kezdve a parancsot kell használni a
search
sablonok keresésére NuGet.org.- Ha a parancssori felület nem talál egyező sablont a meghíváskor
Az alábbi táblázat a .NET SDK-val előre telepített sablonokat mutatja be. A sablon alapértelmezett nyelve a zárójeleken belül jelenik meg. Kattintson a rövid névhivatkozásra az adott sablonbeállítások megtekintéséhez.
Sablonok | Rövid név | Nyelv | Címkék | Bevezetett |
---|---|---|---|---|
Konzolalkalmazás | console |
[C#], F#, VB | Common/Console | 1.0 |
Osztálytár | classlib |
[C#], F#, VB | Common/Library | 1.0 |
WPF-alkalmazás | wpf |
[C#], VB | Common/WPF | 3.0 (VB esetén 5.0) |
WPF-osztálykódtár | wpflib |
[C#], VB | Common/WPF | 3.0 (VB esetén 5.0) |
WPF egyéni vezérlőtár | wpfcustomcontrollib |
[C#], VB | Common/WPF | 3.0 (VB esetén 5.0) |
WPF felhasználói vezérlőtár | wpfusercontrollib |
[C#], VB | Common/WPF | 3.0 (VB esetén 5.0) |
Windows Forms (WinForms) alkalmazás | winforms |
[C#], VB | Common/WinForms | 3.0 (VB esetén 5.0) |
Windows Forms (WinForms) osztálytár | winformslib |
[C#], VB | Common/WinForms | 3.0 (VB esetén 5.0) |
Feldolgozói szolgáltatás | worker |
[C#] | Common/Worker/Web | 3,0 |
MSTest tesztprojekt | mstest |
[C#], F#, VB | Teszt/MSTest | 1.0 |
MSTest tesztosztály | mstest-class |
[C#], F#, VB | Teszt/MSTest | 1.0 |
NUnit 3 tesztprojekt | nunit |
[C#], F#, VB | Teszt/NUnit | 2.1.400 |
NUnit 3 tesztelem | nunit-test |
[C#], F#, VB | Teszt/NUnit | 2,2 |
xUnit tesztprojekt | xunit |
[C#], F#, VB | Teszt/xUnit | 1.0 |
Razor-összetevő | razorcomponent |
[C#] | Web/ASP.NET | 3,0 |
Razor-oldal | page |
[C#] | Web/ASP.NET | 2,0 |
MVC-nézetimportok | viewimports |
[C#] | Web/ASP.NET | 2,0 |
MVC ViewStart | viewstart |
[C#] | Web/ASP.NET | 2,0 |
Blazor Webalkalmazás | blazor |
[C#] | Web/Blazor | 8.0.100 |
BlazorWebAssembly Önálló alkalmazás | blazorwasm |
[C#] | Web/Blazor/WebAssembly/PWA | 3.1.300 |
ASP.NET Core Empty | web |
[C#], F# | Web/Üres | 1.0 |
ASP.NET Core Web App (Model-View-Controller) | mvc |
[C#], F# | Web/MVC | 1.0 |
ASP.NET Core Web App | webapp, razor |
[C#] | Web/MVC/Razor Pages | 2.2, 2.0 |
Razor-osztálytár | razorclasslib |
[C#] | Web/Razor/Library/Razor osztálykönyvtár | 2.1 |
ASP.NET Core, webes API | webapi |
[C#], F# | Web/Web API/API/Szolgáltatás/WebAPI | 1.0 |
ASP.NET Core API | webapiaot |
[C#] | Web/Web API/API/Szolgáltatás | 8.0 |
ASP.NET Core API-vezérlő | apicontroller |
[C#] | Web/ASP.NET | 8.0 |
ASP.NET Core gRPC szolgáltatás | grpc |
[C#] | Web/gRPC | 3,0 |
dotnet gitignore fájl | gitignore |
Konfigurálás | 3,0 | |
global.json fájl | globaljson |
Konfigurálás | 2,0 | |
NuGet Config | nugetconfig |
Konfigurálás | 1.0 | |
Dotnet local tool manifest file | tool-manifest |
Konfigurálás | 3,0 | |
Webes konfiguráció | webconfig |
Konfigurálás | 1.0 | |
Megoldásfájl | sln |
Megoldás | 1.0 | |
Protokollpufferfájl | proto |
Web/gRPC | 3,0 | |
Szerkesztőkonfigurációs fájl | editorconfig |
Konfigurálás | 6,0 |
Az alábbi táblázat a már megszüntetett és a .NET SDK-val már nem előre telepített sablonokat mutatja be. Kattintson a rövid névhivatkozásra az adott sablonbeállítások megtekintéséhez.
Sablonok | Rövid név | Nyelv | Címkék | Azóta megszűnt |
---|---|---|---|---|
ASP.NET Core és Angular | angular |
[C#] | Web/MVC/SPA | 8.0 |
ASP.NET Core with React.js | react |
[C#] | Web/MVC/SPA | 8.0 |
Blazor Kiszolgálóalkalmazás | blazorserver |
[C#] | Web/Blazor | 8.0 |
Blazor Kiszolgálóalkalmazás üres | blazorserver-empty |
[C#] | Web/Blazor | 8.0 |
BlazorWebAssembly Alkalmazás üres | blazorwasm-empty |
[C#] | Web/Blazor/WebAssembly | 8.0 |
Beállítások
--dry-run
Megjeleníti annak összegzését, hogy mi történne, ha az adott parancs futtatása sablonlétrehozáshoz vezetne. A .NET Core 2.2 SDK óta érhető el.
--force
Akkor is kényszeríti a tartalom létrehozására, ha az módosítaná a meglévő fájlokat. Erre akkor van szükség, ha a kiválasztott sablon felülírja a kimeneti könyvtárban lévő meglévő fájlokat.
-?|-h|--help
Kiírja a parancs súgóját. A parancs maga vagy bármely sablon esetében hívható meg
dotnet new
. Például:dotnet new mvc --help
.-lang|--language {C#|F#|VB}
A létrehozandó sablon nyelve. Az elfogadott nyelv a sablontól függően változik (lásd az argumentumok szakaszban szereplő alapértelmezett értékeket ). Egyes sablonok esetében érvénytelen.
Feljegyzés
Egyes rendszerhéjak speciális karakterként értelmeznek
#
. Ezekben az esetekben idézőjelekbe foglalja a nyelvi paraméter értékét. Például:dotnet new console -lang "F#"
.-n|--name <OUTPUT_NAME>
A létrehozott kimenet neve. Ha nincs megadva név, a rendszer az aktuális könyvtár nevét használja.
-f|--framework <FRAMEWORK>
Megadja a cél keretrendszert. Cél-keretrendszer-monikerre (TFM) számít. Példák: "net6.0", "net7.0-macos". Ez az érték megjelenik a projektfájlban.
-no-update-check
A sabloncsomag-frissítések keresésének letiltása sablon létrehozásakor. A .NET SDK 6.0.100 óta érhető el. Amikor a sablont egy, a használatával
dotnet new --install
telepített sabloncsomagból példányosítva ellenőrzi,dotnet new
hogy van-e frissítés a sablonhoz. A .NET 6-tól kezdődően nem történik frissítési ellenőrzés az alapértelmezett .NET-sablonok esetében. A .NET alapértelmezett sablonjainak frissítéséhez telepítse a .NET SDK javításverzióját.-o|--output <OUTPUT_DIRECTORY>
A létrehozott kimenet elhelyezésének helye. Az alapértelmezett az aktuális könyvtár.
--project <PROJECT_PATH>
A sablonhoz hozzáadott projekt. Ez a projekt a környezet kiértékelésére szolgál. Ha nincs megadva, a program az aktuális vagy szülőkönyvtárakban lévő projektet használja. A .NET SDK 7.0.100 óta érhető el.
-d|--diagnostics
Engedélyezi a diagnosztikai kimenetet. A .NET SDK 7.0.100 óta érhető el.
-v|--verbosity <LEVEL>
A parancs részletességi szintjét állítja be. Az engedélyezett értékek a következők
q[uiet]
: ,m[inimal]
n[ormal]
ésdiag[nostic]
. A .NET SDK 7.0.100 óta érhető el.
Sablonbeállítások
Előfordulhat, hogy minden sablonhoz további beállítások is meg vannak határozva. További információt a .NET alapértelmezett sablonjaiban dotnet new
talál.
Példák
Hozzon létre egy C#-konzolalkalmazás-projektet:
dotnet new console
Hozzon létre egy F#-konzolalkalmazás-projektet az aktuális könyvtárban:
dotnet new console --language "F#"
Hozzon létre egy .NET Standard 2.0 osztálytárprojektet a megadott könyvtárban:
dotnet new classlib --framework "netstandard2.0" -o MyLibrary
Hozzon létre egy új ASP.NET Core C# MVC-projektet az aktuális könyvtárban hitelesítés nélkül:
dotnet new mvc -au None
Hozzon létre egy új xUnit-projektet:
dotnet new xunit
Hozzon létre egy global.json az aktuális könyvtárban, amely az SDK 8.0.101-es verzióját állítja be:
dotnet new globaljson --sdk-version 8.0.101 --roll-forward latestFeature
A C#-konzolalkalmazás-sablon súgójának megjelenítése:
dotnet new console -h
Súgó megjelenítése az F# konzolalkalmazás-sablonhoz:
dotnet new console --language "F#" -h