dotnet new

Bu makale şu şekilde geçerlidir: ✔️ .net Core 2,0 SDK ve sonraki sürümleri

Name

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

Özeti

dotnet new <TEMPLATE> [--dry-run] [--force] [-lang|--language {"C#"|"F#"|VB}]
    [-n|--name <OUTPUT_NAME>] [--no-update-check] [-o|--output <OUTPUT_DIRECTORY>] [Template options]

dotnet new -h|--help

Description

dotnet newKomut bir şablonu temel alan bir .NET projesi veya başka yapılar oluşturur.

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

Örtük geri yükleme

,,,, dotnet restore Ve gibi geri yükleme gerektiren tüm komutlar tarafından örtük olarak çalıştırıldığı için çalıştırmanız gerekmez dotnet new dotnet build dotnet run dotnet test dotnet publish dotnet pack . Örtük geri yüklemeyi devre dışı bırakmak için --no-restore seçeneğini kullanın.

dotnet restoreBu komut, açıkça geri yükleme işleminin, Azure DevOps Services veya derleme sistemlerindeki sürekli tümleştirme yapıları gibi, geri yüklemenin ne zaman gerçekleşeceğini açıkça denetmasının gerektiği bazı senaryolarda de yararlıdır.

NuGet beslemelerini yönetme hakkında daha fazla bilgi için dotnet restore belgelerinebakın.

Bağımsız değişkenler

• TEMPLATE

  Komut çağrıldığında örnek oluşturulacak şablon. Her şablonun geçirebilmeniz için özel seçenekleri olabilir. Daha fazla bilgi için bkz. şablon seçenekleri.

  dotnet new --listTüm yüklü şablonların bir listesini görmek için ' i çalıştırabilirsiniz.

  .net core 3,0 sdk ile başlayıp .net core 5.0.300 sdk ile biten clı, aşağıdaki koşullarda komutu çağırdığınızda NuGet. org içindeki şablonları arar dotnet new :

  • CLı çağrılırken bir şablon eşleşmesi bulamazsa dotnet new , bu da kısmi değildir.
  • Şablonun daha yeni bir sürümü kullanılabilir. Bu durumda, proje veya yapıt oluşturulur ancak CLı, şablonun güncelleştirilmiş bir sürümü hakkında sizi uyarır.

  .net Core 5.0.300 SDK ile başlayarak, --search seçeneği NuGet. org içindeki şablonları aramak için kullanılmalıdır.

  Aşağıdaki tabloda .NET SDK ile önceden yüklenmiş olarak gelen şablonlar gösterilmektedir. Şablon için varsayılan dil, köşeli ayraçlar içinde gösterilir. Özel şablon seçeneklerini görmek için kısa ad bağlantısına tıklayın.

Seçenekler

• --dry-run

  Verilen komutun bir şablon oluşturma işlemiyle sonuçlansa ne olacağının özetini görüntüler. .NET Core 2.2 SDK'dan itibaren kullanılabilir.

• --force

  Mevcut dosyaları değiştirse bile içeriği oluşturulmaya iter. Seçilen şablon, çıkış dizininde mevcut dosyaları geçersiz k gerektiğinde bu gereklidir.

• -?|-h|--help

  komutu için yardım yazdırır. Komutun kendisi veya herhangi dotnet new bir şablon için çağrılabilir. Örneğin, dotnet new mvc --help.

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

  Oluşturulan şablonun dili. Kabul edilen dil şablona göre değişir (bağımsız değişkenler bölümünde varsayılanlara bakın). Bazı şablonlar için geçerli değildir.

  Not

  Bazı kabuklar özel # karakter olarak yorumlanır. 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ı. Bir ad belirtilmezse geçerli dizinin adı kullanılır.

• -no-update-check

  Şablon örneği oluşturma sırasında şablon paketi güncelleştirmelerini denetlemeyi devre dışı bırakma. .NET 6.0.100 SDK'dan itibaren kullanılabilir. kullanılarak yüklenmiş bir şablon paketinden şablonun örneğini güncelleştirmeyi dotnet new --install dotnet new 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ı düzeltme eki sürümünü yükleyin.

• -o|--output <OUTPUT_DIRECTORY>

  Oluşturulan çıkışın yerinin konumu. Geçerli dizin varsayılandır.

Şablon seçenekleri

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

Örnekler

• C# konsol uygulaması projesi oluşturun:

  dotnet new console
  

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

  dotnet new console --language "F#"
  

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

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

• Geçerli dizinde kimlik ASP.NET Core yeni bir 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ü 3.1.101 olarak ayar alan bir global.json oluşturun:

  dotnet new globaljson --sdk-version 3.1.101
  

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

  dotnet new console -h
  

• F # Konsolu uygulama şablonu için yardımı göster:

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

Ayrıca bkz.

• DotNet New--List seçeneği
• DotNet New--Search seçeneği
• DotNet New--install seçeneği
• DotNet New için .NET varsayılan şablonları
• DotNet New için özel şablonlar
• Dotnet new için özel şablon oluşturma
• dotnet/dotnet-şablon-örnek GitHub deposu