Megosztás:

dotnet új <SABLON>

Ez a cikk a következő verziókra vonatkozik: ✔️ .NET 6 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

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.

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

    A parancs használatának leírását nyomtatja ki.

  • -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]d[etailed]és diag[nostic]. További információért lásd LoggerVerbosity.

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

  • Last updated on