dotnet új lista

  • Cikk

Ez a cikk a következő kiadásokra vonatkozik: ✔️ .NET Core 3.1 SDK és újabb verziók

Name

dotnet new list – Listázza a használatával dotnet newfuttatandó elérhető sablonokat.

Áttekintés

dotnet new list [<TEMPLATE_NAME>] [--author <AUTHOR>] [-lang|--language {"C#"|"F#"|VB}]
    [--tag <TAG>] [--type <TYPE>] [--columns <COLUMNS>] [--columns-all]
    [-o|--output <output>] [--project <project>] [--ignore-constraints]
    [-d|--diagnostics] [--verbosity <LEVEL>] [-h|--help]

Description

A dotnet new list parancs felsorolja a használható dotnet newsablonokat. Ha a <TEMPLATE_NAME> meg van adva, a megadott nevet tartalmazó sablonokat listázza. Ez a beállítás csak az alapértelmezett és a telepített sablonokat listázza. Ha helyileg telepíthető sablonokat szeretne keresni a NuGetben, használja a search parancsot.

A .NET SDK 7.0.100-as verziótól kezdve előfordulhat, hogy a list parancs nem jeleníti meg a gépen telepített összes sablont. Figyelembe veszi a sablonkorlátozások eredményét, és a nem használható sablonok nem jelennek meg. Az összes sablon megjelenítésének kényszerítéséhez használja a --ignore-constraints lehetőséget.

Megjegyzés

A .NET 7 SDK-tól kezdve a dotnet new szintaxis megváltozott:

  • A --list, --search, --installés --uninstall lehetőség lett list, search, , installés uninstall alparancs.
  • 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 a vagy --help a -h beállításon keresztül: dotnet new <subcommand> --help az alparancs összes támogatott beállítását felsorolja.

Emellett a lapkiegészítés is 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 lehetőségeket. A .NET SDK lapkiegészítésének aktiválásához lásd: Lapkiegészítés engedélyezése.

Példák a régi szintaxisra:

  • Az összes egyoldalas alkalmazássablon (SPA) listázása:

    • óta .NET SDK 6.0.100
    dotnet new --list spa
    • .NET SDK 6.0.100 előtt
    dotnet new spa --list

Argumentumok

  • TEMPLATE_NAME

    Ha az argumentum meg van adva, csak a sablonnévben vagy a rövid névben szereplő <TEMPLATE_NAME> sablonok jelennek meg.

Beállítások

  • --author <AUTHOR>

    Sablonok szűrése sablonszerző alapján. A részleges egyezés támogatott. A .NET SDK 5.0.300 óta érhető el.

  • --columns <COLUMNS>

    A kimenetben megjelenítendő oszlopok vesszővel tagolt listája. A támogatott oszlopok a következők:

    • language – A sablon által támogatott nyelvek vesszővel tagolt listája.
    • tags – A sabloncímkék listája.
    • author - A sablon szerzője.
    • type – A sablon típusa: projekt vagy elem.

    A sablon neve és a rövid név mindig megjelenik. Az oszlopok alapértelmezett listája a sablon neve, a rövid név, a nyelv és a címkék. Ez a lista egyenértékű a megadásával --columns=language,tags. A .NET SDK 5.0.300 óta érhető el.

  • --columns-all

    Megjeleníti a kimenet összes oszlopát. A .NET SDK 5.0.300 óta érhető el.

  • -d|--diagnostics

    Engedélyezi a diagnosztikai kimenetet. A .NET SDK 7.0.100 óta érhető el.

  • -h|--help

    Kiírja a listaparancs súgóját. A .NET SDK 7.0.100 óta érhető el.

  • --ignore-constraints

    Letiltja annak ellenőrzését, hogy a sablon megfelel-e a futtatandó korlátozásoknak. A .NET SDK 7.0.100 óta érhető el.

  • -lang|--language {C#|F#|VB}

    A sablon által támogatott nyelv alapján szűri a sablonokat. Az elfogadott nyelv a sablontól függően változik. Egyes sablonok nem érvényesek.

    Megjegyzés

    Egyes héjak speciális karakterként értelmezik # . Ezekben az esetekben a nyelvi paraméter értékét idézőjelek között kell megadni. Például: dotnet new --list --language "F#".

  • -o|--output <OUTPUT_DIRECTORY>

    A létrehozott kimenet elhelyezésének helye. Az alapértelmezett érték az aktuális könyvtár. A listaparancs esetében szükség lehet a kimeneti könyvtár megadására a sablon korlátainak helyes kiértékeléséhez. A .NET SDK 7.0.100 óta érhető el.

  • --project <PROJECT_PATH>

    A projekt, amelyhez a sablon hozzá van adva. A listaparancs esetében előfordulhat, hogy meg kell adnia azt a projektet, amelybe a sablon hozzá van adva a sablon megkötéseinek helyes kiértékeléséhez. A .NET SDK 7.0.100 óta érhető el.

  • --tag <TAG>

    Sabloncímkék alapján szűri a sablonokat. A kiválasztáshoz a sablonnak legalább egy olyan címkével kell rendelkeznie, amely pontosan megfelel a feltételeknek. A .NET SDK 5.0.300 óta érhető el.

  • --type <TYPE>

    Sablontípus alapján szűri a sablonokat. Az előre definiált értékek a következők: project, itemés solution.

  • -v|--verbosity <LEVEL>

    Beállítja a parancs részletességi szintjét. Az engedélyezett értékek a következők: q[uiet], m[inimal], n[ormal]és diag[nostic]. A .NET SDK 7.0.100 óta érhető el.

Példák

  • Az összes sablon listázása

    dotnet new list

  • Az összes egyoldalas alkalmazássablon (SPA) listázása:

    dotnet new list spa

  • Listázzuk az összes olyan sablont, amely megfelel a részsztringnek.

    dotnet new list we

  • Listázzuk az összes olyan sablont, amely megfelel az F#-nyelvet támogató sztringnek.

    dotnet new list we --language "F#"

  • Az összes elemsablon listázása.

    dotnet new list --type item

  • Listázhatja az összes C#-sablont, és megjelenítheti a szerzőt és a kimenetben szereplő típust.

    dotnet new list --language "C#" --columns "author,type"

Lásd még