dotnet new list

  • Makale

Bu makale şunlar için geçerlidir: ✔️ .NET Core 3.1 SDK ve sonraki sürümler

Name

dotnet new list - kullanılarak dotnet newçalıştırılacak kullanılabilir şablonları listeler.

Özet

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

dotnet new list komutu ile dotnet newkullanılacak kullanılabilir şablonları listeler. <TEMPLATE_NAME> belirtilirse, belirtilen adı içeren şablonları listeler. Bu seçenek yalnızca varsayılan ve yüklü şablonları listeler. NuGet'te yerel olarak yükleyebileceğiniz şablonları bulmak için komutunu kullanın search .

.NET SDK 7.0.100'den başlayarak, list komut makinede yüklü olan tüm şablonları göstermeyebilir. Şablon kısıtlamalarının sonucunu dikkate alır ve kullanılamayacak şablonlar gösterilmez. Tüm şablonları göstermeye zorlamak için seçeneğini kullanın --ignore-constraints .

Not

.NET 7 SDK'sı ile başlayarak söz dotnet new dizimi değişti:

  • , , ve seçenekleri , , installsearchve uninstall alt komutları haline geldilist.--uninstall--install--search--list
  • seçeneği --update-apply alt komut haline geldi update .
  • kullanmak --update-checkiçin seçeneğiyle update birlikte --check-only alt komutunu kullanın.

Daha önce kullanılabilir olan diğer seçenekler, ilgili alt komutları ile birlikte kullanılmaya devam eder. Her alt komut için veya --help seçeneği aracılığıyla -h ayrı yardım sağlanır: dotnet new <subcommand> --help alt komut için desteklenen tüm seçenekleri listeler.

Ayrıca, artık için dotnet newsekme tamamlama kullanılabilir. Yüklü şablon adları ve seçili bir şablonun sağladığı seçenekler için tamamlanmasını destekler. .NET SDK'sı için sekme tamamlama özelliğini etkinleştirmek için bkz. Sekme tamamlamayı etkinleştirme.

Eski söz dizimi örnekleri:

  • Tüm Tek Sayfalı Uygulama (SPA) şablonlarını listeleyin:

    • .NET SDK 6.0.100'den beri
    dotnet new --list spa
    • .NET SDK 6.0.100 öncesi
    dotnet new spa --list

Bağımsız değişkenler

  • TEMPLATE_NAME

    Bağımsız değişken belirtilirse, yalnızca şablon adında veya kısa adda bulunan <TEMPLATE_NAME> şablonlar gösterilir.

Seçenekler

  • --author <AUTHOR>

    Şablonları şablon yazarına göre filtreler. Kısmi eşleşme desteklenir. .NET SDK 5.0.300'den itibaren kullanılabilir.

  • --columns <COLUMNS>

    Çıkışta görüntülenecek sütunların virgülle ayrılmış listesi. Desteklenen sütunlar şunlardır:

    • language - Şablon tarafından desteklenen dillerin virgülle ayrılmış listesi.
    • tags - Şablon etiketlerinin listesi.
    • author - Şablon yazarı.
    • type - Şablon türü: proje veya öğe.

    Şablon adı ve kısa ad her zaman gösterilir. Varsayılan sütun listesi şablon adı, kısa ad, dil ve etiketlerdir. Bu liste, belirtilmesiyle --columns=language,tagseşdeğerdir. .NET SDK 5.0.300'den itibaren kullanılabilir.

  • --columns-all

    Çıktıdaki tüm sütunları görüntüler. .NET SDK 5.0.300'den itibaren kullanılabilir.

  • -d|--diagnostics

    Tanılama çıkışını etkinleştirir. .NET SDK 7.0.100'den itibaren kullanılabilir.

  • -h|--help

    Liste komutu için yardımı yazdırır. .NET SDK 7.0.100'den itibaren kullanılabilir.

  • --ignore-constraints

    Şablonun çalıştırılacak kısıtlamaları karşılayıp karşılamadiğini denetlemeyi devre dışı bırakır. .NET SDK 7.0.100'den itibaren kullanılabilir.

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

    Şablonları şablon tarafından desteklenen dile göre filtreler. Kabul edilen dil şablona göre değişir. Bazı şablonlar için geçerli değil.

    Not

    Bazı kabuklar özel bir karakter olarak yorumlar # . Böyle durumlarda dil parametresi değerini tırnak içine alın. Örneğin, dotnet new --list --language "F#".

  • -o|--output <OUTPUT_DIRECTORY>

    Oluşturulan çıkışı yerleştirmek için konum. Geçerli dizin varsayılandır. List komutu için, şablonun kısıtlamalarını doğru şekilde değerlendirmek için çıkış dizinini belirtmek gerekebilir. .NET SDK 7.0.100'den itibaren kullanılabilir.

  • --project <PROJECT_PATH>

    Şablonun eklendiği proje. Liste komutu için, şablonun kısıtlamaları doğru şekilde değerlendirmek için şablonun eklendiği projeyi belirtmek gerekebilir. .NET SDK 7.0.100'den itibaren kullanılabilir.

  • --tag <TAG>

    Şablonları şablon etiketlerine göre filtreler. Bir şablonun seçilmesi için ölçütle tam olarak eşleşen en az bir etiket olması gerekir. .NET SDK 5.0.300'den itibaren kullanılabilir.

  • --type <TYPE>

    Şablonları şablon türüne göre filtreler. Önceden tanımlanmış değerler , itemve solutiondeğerleridirproject.

  • -v|--verbosity <LEVEL>

    Komutun ayrıntı düzeyini ayarlar. İzin verilen değerler , m[inimal], n[ormal]ve diag[nostic]değerleridirq[uiet]. .NET SDK 7.0.100'den itibaren kullanılabilir.

Örnekler

  • Tüm şablonları listeleme

    dotnet new list

  • Tüm Tek Sayfalı Uygulama (SPA) şablonlarını listeleyin:

    dotnet new list spa

  • Alt dizeyle eşleşen tüm şablonları listeleyin.

    dotnet new list we

  • F# dilini destekleyen alt dizeyle eşleşen tüm şablonları listeleyin.

    dotnet new list we --language "F#"

  • Tüm öğe şablonlarını listeleyin.

    dotnet new list --type item

  • Çıktıdaki yazarı ve türü gösteren tüm C# şablonlarını listeleyin.

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

Ayrıca bkz.