dotnet új lista
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 new
futtatandó 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 new
sablonokat. 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 lettlist
,search
, ,install
ésuninstall
alparancs. - 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 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
éssolution
.-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]
ésdiag[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"