Aracılığıyla paylaş

dotnet new <TEMPLATE>

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

Veri Akışı Adı

dotnet new - Belirtilen şablonu temel alan yeni bir proje, yapılandırma dosyası veya çözüm oluşturur.

Özet

dotnet new <TEMPLATE> [--dry-run] [--force] [-lang|--language {"C#"|"F#"|VB}]
    [-n|--name <OUTPUT_NAME>] [-f|--framework <FRAMEWORK>] [--no-update-check]
    [-o|--output <OUTPUT_DIRECTORY>] [--project <PROJECT_PATH>]
    [-d|--diagnostics] [--verbosity <LEVEL>] [Template options]

dotnet new -h|--help

Açıklama

komutu, dotnet new şablona dayalı bir .NET projesi veya diğer yapıtlar oluşturur.

komut, belirtilen şablon ve seçeneklere göre diskte yapıtlar oluşturmak için şablon altyapısını çağırır.

Not

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

  • , , ve seçenekleri , , --list--searchve --install alt komutları oldu--uninstall.listsearchinstalluninstall
  • Bu --update-apply seçenek 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. Veya seçeneği aracılığıyla -h--help her alt komut için 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 sekme tamamlama kullanılabilir dotnet new. 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.

Sekme tamamlama

.NET SDK 7.0.100'den başlayarak, için dotnet newsekme tamamlama kullanılabilir. Yüklü şablon adları için tamamlamanın yanı sıra seçili 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.

Örtük geri yükleme

, , dotnet restoreve dotnet newgibi dotnet builddotnet rundotnet testdotnet publishgeri yükleme gerektiren tüm komutlar tarafından örtük olarak çalıştırıldığından, komutunu çalıştırmanız dotnet pack gerekmez. Örtük geri yüklemeyi devre dışı bırakmak için seçeneğini kullanın --no-restore .

Komutudotnet restore, Azure DevOps Services'teki sürekli tümleştirme derlemeleri veya geri yüklemenin ne zaman gerçekleştiğini açıkça denetlemesi gereken derleme sistemleri gibi açıkça geri yüklemenin anlamlı olduğu bazı senaryolarda hala yararlıdır.

NuGet akışlarını yönetme hakkında bilgi için belgelere dotnet restore bakın.

Bağımsız değişkenler

  • TEMPLATE

    Komut çağrıldığında örnek oluşturacak şablon. Her şablonun geçirebileceğiniz belirli seçenekleri olabilir. Daha fazla bilgi için bkz . Şablon seçenekleri.

    Tüm yüklü şablonların listesini görmek için komutunu çalıştırabilirsiniz dotnet new list .

    komutu, search NuGet.org şablonları aramak için kullanılmalıdır.

    .NET SDK ile birlikte gelen şablonların listesi için bkz. Önceden yüklenmiş şablonlar.

Seçenekler

  • --dry-run

    Verilen komut çalıştırıldığında bir şablon oluşturulmasına neden olursa neler olacağının özetini görüntüler.

  • --force

    Mevcut dosyaları değiştirse bile içeriğin oluşturulmasını zorlar. Seçilen şablon çıktı dizinindeki mevcut dosyaları geçersiz kıldığında bu gereklidir.

  • -?|-h|--help

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

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

    Oluşturulacak şablonun dili. Kabul edilen dil şablona göre değişir (bağımsız değişkenler bölümündeki varsayılan değerlere bakın). 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 console -lang "F#".

  • -n|--name <OUTPUT_NAME>

    Oluşturulan çıkışın adı. Ad belirtilmezse, geçerli dizinin adı kullanılır.

  • -f|--framework <FRAMEWORK>

    Hedef çerçeveyi belirtir. Bir hedef çerçeve adı (TFM) bekler. Örnekler: "net6.0", "net7.0-macos". Bu değer proje dosyasına yansıtılır.

  • -no-update-check

    Şablon örneği oluştururken şablon paketi güncelleştirmelerinin denetlenme özelliğini devre dışı bırakır. .NET SDK 6.0.100'den itibaren kullanılabilir. kullanılarak dotnet new --installdotnet new yüklenen bir şablon paketinden şablonun örneğini oluştururken, şablon için bir güncelleştirme olup olmadığını denetler. .NET 6'dan başlayarak, .NET varsayılan şablonları için güncelleştirme denetimi yapılmaz. .NET varsayılan şablonlarını güncelleştirmek için .NET SDK'sının düzeltme eki sürümünü yükleyin.

  • -o|--output <OUTPUT_DIRECTORY>

    Oluşturulan çıkışı yerleştirmek için konum. Geçerli dizin varsayılandır.

  • --project <PROJECT_PATH>

    Şablonun eklendiği proje. Bu proje bağlam değerlendirmesi için kullanılır. Belirtilmezse, geçerli veya üst dizinlerdeki proje kullanılır. .NET SDK 7.0.100'den itibaren kullanılabilir.

  • -d|--diagnostics

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

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

Şablon seçenekleri

Her şablonun tanımlanmış ek seçenekleri olabilir. Daha fazla bilgi için bkz . için dotnet new.NET varsayılan şablonları.

Örnekler

  • C# konsol uygulaması projesi oluşturma:

    dotnet new console

  • Geçerli dizinde bir F# konsol uygulaması projesi oluşturun:

    dotnet new console --language "F#"

  • Belirtilen dizinde bir .NET Standard 2.0 sınıf kitaplığı projesi oluşturun:

    dotnet new classlib --framework "netstandard2.0" -o MyLibrary

  • Geçerli dizinde kimlik doğrulaması olmadan yeni bir ASP.NET Core C# MVC projesi oluşturun:

    dotnet new mvc -au None

  • Yeni bir xUnit projesi oluşturun:

    dotnet new xunit

  • GEÇERLI dizinde SDK sürümünü 8.0.101 olarak ayarlı bir global.json oluşturun:

    dotnet new globaljson --sdk-version 8.0.101 --roll-forward latestFeature

  • C# konsol uygulaması şablonu için yardımı göster:

    dotnet new console -h

  • F# konsol uygulaması şablonu için yardım göster:

    dotnet new console --language "F#" -h

Ayrıca bkz.

  • Last updated on