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.

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.

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.

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 --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
  

Lásd még

• dotnet new list command
• dotnet new search command
• dotnet új telepítési parancs
• .NET alapértelmezett sablonok az új dotnethez
• Új dotnet egyéni sablonjai
• Egyéni sablon létrehozása új dotnethez