daftar baru dotnet
Artikel ini berlaku untuk: ️ .NET Core 3.1 SDK dan versi yang lebih baru
Nama
dotnet new list
- Mencantumkan templat yang tersedia untuk dijalankan menggunakan dotnet new
.
Sinopsis
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]
Deskripsi
Perintah mencantumkan dotnet new list
templat yang tersedia untuk digunakan dengan dotnet new
. <Jika TEMPLATE_NAME> ditentukan, mencantumkan templat yang berisi nama yang ditentukan. Opsi ini hanya mencantumkan templat default dan terinstal. Untuk menemukan templat di NuGet yang dapat Anda instal secara lokal, gunakan search
perintah .
Dimulai dengan .NET SDK 7.0.100, list
perintah mungkin tidak menampilkan semua templat yang diinstal pada komputer. Ini memperhitungkan hasil batasan templat, dan templat yang tidak dapat digunakan tidak akan ditampilkan. Untuk menampilkan semua templat secara paksa, gunakan --ignore-constraints
opsi .
Catatan
Dimulai dengan .NET 7 SDK, dotnet new
sintaksnya telah berubah:
- Opsi
--list
,--search
,--install
, dan--uninstall
menjadilist
sub perintah ,search
,install
, danuninstall
. - Opsi
--update-apply
menjadi subperintahupdate
. - Untuk menggunakan
--update-check
, gunakanupdate
sub perintah dengan--check-only
opsi .
Opsi lain yang tersedia sebelumnya masih tersedia untuk digunakan dengan subperintah opsi masing-masing.
Bantuan terpisah untuk setiap subperintah tersedia melalui opsi -h
atau --help
: dotnet new <subcommand> --help
mencantumkan semua opsi yang didukung untuk subperintah.
Selain itu, penyelesaian tab sekarang tersedia untuk dotnet new
. Ini mendukung penyelesaian untuk nama templat yang diinstal dan untuk opsi yang disediakan templat yang dipilih.
Untuk mengaktifkan penyelesaian tab untuk SDK .NET, lihat Mengaktifkan penyelesaian tab.
Contoh sintaks lama:
Cantumkan semua templat Aplikasi Halaman Tunggal (SPA):
- sejak .NET SDK 6.0.100
dotnet new --list spa
- sebelum .NET SDK 6.0.100
dotnet new spa --list
Argumen
TEMPLATE_NAME
Jika argumen ditentukan, hanya templat yang berisi
<TEMPLATE_NAME>
nama templat atau nama pendek yang akan ditampilkan.
Opsi
--author <AUTHOR>
Memfilter templat berdasarkan pembuat templat. Kecocokan parsial didukung. Tersedia sejak .NET SDK 5.0.300.
--columns <COLUMNS>
Daftar kolom yang dipisahkan koma untuk ditampilkan dalam output. Kolom yang didukung adalah:
language
- Daftar bahasa yang dipisahkan koma yang didukung oleh templat.tags
- Daftar tag templat.author
- Penulis templat.type
- Jenis templat: proyek atau item.
Nama templat dan nama pendek selalu ditampilkan. Daftar default kolom adalah nama templat, nama pendek, bahasa, dan tag. Daftar ini setara dengan menentukan
--columns=language,tags
. Tersedia sejak .NET SDK 5.0.300.--columns-all
Menampilkan semua kolom dalam output. Tersedia sejak .NET SDK 5.0.300.
-d|--diagnostics
Mengaktifkan output diagnostik. Tersedia sejak .NET SDK 7.0.100.
-h|--help
Mencetak bantuan untuk perintah daftar. Tersedia sejak .NET SDK 7.0.100.
--ignore-constraints
Menonaktifkan pemeriksaan apakah templat memenuhi batasan yang akan dijalankan. Tersedia sejak .NET SDK 7.0.100.
-lang|--language {C#|F#|VB}
Memfilter templat berdasarkan bahasa yang didukung oleh templat. Bahasa yang diterima bervariasi menurut templat. Tidak valid untuk beberapa templat.
Catatan
Beberapa shell menafsirkan
#
sebagai karakter khusus. Dalam kasus tersebut, sertakan nilai parameter bahasa dalam tanda kutip. Contohnya:dotnet new --list --language "F#"
-o|--output <OUTPUT_DIRECTORY>
Lokasi untuk menempatkan output yang dihasilkan. Defaultnya adalah direktori saat ini. Untuk perintah daftar, mungkin perlu untuk menentukan direktori output untuk mengevaluasi batasan templat dengan benar. Tersedia sejak .NET SDK 7.0.100.
--project <PROJECT_PATH>
Proyek tempat templat ditambahkan. Untuk perintah daftar, mungkin diperlukan untuk menentukan proyek tempat templat ditambahkan untuk mengevaluasi batasan templat dengan benar. Tersedia sejak .NET SDK 7.0.100.
--tag <TAG>
Memfilter templat berdasarkan tag templat. Untuk dipilih, templat harus memiliki setidaknya satu tag yang sama persis dengan kriteria. Tersedia sejak .NET SDK 5.0.300.
--type <TYPE>
Memfilter templat berdasarkan jenis templat. Nilai yang telah ditentukan sebelumnya adalah
project
, ,item
dansolution
.-v|--verbosity <LEVEL>
Mengatur tingkat verbositas perintah. Nilai yang diizinkan adalah
q[uiet]
,m[inimal]
,n[ormal]
, dandiag[nostic]
. Tersedia sejak .NET SDK 7.0.100.
Contoh
Mencantumkan semua templat
dotnet new list
Cantumkan semua templat Aplikasi Halaman Tunggal (SPA):
dotnet new list spa
Cantumkan semua templat yang cocok dengan substring kami .
dotnet new list we
Cantumkan semua templat yang cocok dengan substring kami yang mendukung bahasa F#.
dotnet new list we --language "F#"
Cantumkan semua templat item.
dotnet new list --type item
Cantumkan semua templat C#, memperlihatkan pembuat dan jenis dalam output.
dotnet new list --language "C#" --columns "author,type"