dotnet új <SABLON>

  • Cikk

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 lettek list, searchés installuninstall alparancsok.
  • A --update-apply lehetőség lett az update alparancs.
  • A használatához --update-checkhasználja az update 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.

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
Egységteszt projekt mstest [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 --installtelepí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őkq[uiet]: , m[inimal]n[ormal]és diag[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 newtalá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

  • 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

Lásd még