dotnet new list - (Bu komut .NET şablon listesini görüntüler.)

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

İsim

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 .

Uyarı

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

  • --list, --search, --installve --uninstall seçenekleri list, search, installve uninstall alt komutları haline geldi.
  • --update-apply seçeneği update alt komutu haline geldi.
  • --update-checkkullanmak için update seçeneğiyle --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 ayrı yardım -h veya --help seçeneği aracılığıyla sağlanır: dotnet new <subcommand> --help alt komut için desteklenen tüm seçenekleri listeler.

Ayrıca, sekme tamamlama özelliği artık dotnet newiçin kullanılabilir. Yüklü şablon adlarının ve seçilen bir şablonun sağladığı seçeneklerin 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 itibaren
    dotnet new --list spa
    
    • .NET SDK 6.0.100 öncesi
    dotnet new spa --list
    

Arguments

  • TEMPLATE_NAME

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

Options

  • --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>

    Çıktıda 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

    komutunun nasıl kullanılacağına ilişkin bir açıklama yazdırır.

  • --ignore-constraints

    Şablonun çalıştırılacak kısıtlamalara uygun olup olmadığını 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.

    Uyarı

    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çütlere tam olarak uyan 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 , projectve itemdeğerleridirsolution.

  • -v|--verbosity <LEVEL>

    Komutun ayrıntı düzeyini ayarlar. İzin verilen değerler , q[uiet], m[inimal], n[ormal]ve d[etailed]diag[nostic]. Daha fazla bilgi için bkz. LoggerVerbosity.

Ö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 bakınız