Bagikan melalui


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 menjadi listsub perintah , search, install, dan uninstall .
  • Opsi --update-apply menjadi subperintah update.
  • Untuk menggunakan --update-check, gunakan update 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, , itemdan solution.

  • -v|--verbosity <LEVEL>

    Mengatur tingkat verbositas perintah. Nilai yang diizinkan adalah q[uiet], m[inimal], n[ormal], dan diag[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"
    

Lihat juga