Aracılığıyla paylaş

dotnet komutu

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

İsim

dotnet - .NET CLI için genel sürücü.

Özet

Kullanılabilir komutlar ve ortam hakkında bilgi almak için:

dotnet [--version] [--info] [--list-runtimes] [--list-sdks]

dotnet -h|--help

Bir komutu çalıştırmak için (SDK yüklemesi gerekir):

dotnet <COMMAND> [-d|--diagnostics] [-h|--help] [--verbosity <LEVEL>]
    [command-options] [arguments]

Bir uygulamayı çalıştırmak için:

dotnet [--additionalprobingpath <PATH>] [--additional-deps <PATH>]
    [--fx-version <VERSION>]  [--roll-forward <SETTING>]
    <PATH_TO_APPLICATION> [arguments]

dotnet exec [--additionalprobingpath <PATH>] [--additional-deps <PATH>]
    [--depsfile <PATH>]
    [--fx-version <VERSION>]  [--roll-forward <SETTING>]
    [--runtimeconfig <PATH>]
    <PATH_TO_APPLICATION> [arguments]

Açıklama

Komutun dotnet iki işlevi vardır:

  • .NET projeleriyle çalışmaya yönelik komutlar sağlar.

    Örneğin, dotnet build bir proje oluşturur. Her komut kendi seçeneklerini ve bağımsız değişkenlerini tanımlar. Tüm komutlar, komutun --help nasıl kullanılacağına ilişkin kısa belgeleri yazdırma seçeneğini destekler.

  • .NET uygulamaları çalıştırır.

    Uygulamayı çalıştırmak için bir uygulama .dll dosyasının yolunu belirtirsiniz. Uygulamayı çalıştırmak, giriş noktasını bulmak ve yürütmek anlamına gelir. Bu, konsol uygulamaları söz konusu olduğunda yöntemidir Main . Örneğin, dotnet myapp.dll uygulamayı çalıştırır myapp . Dağıtım seçenekleri hakkında bilgi edinmek için bkz. .NET uygulama dağıtımı.

Seçenekler

Farklı seçenekler şunlar için kullanılabilir:

  • Ortam hakkındaki bilgileri görüntüleme.
  • Komut çalıştırma.
  • Bir uygulamayı çalıştırma.

Ortam bilgilerini ve kullanılabilir komutları görüntüleme seçenekleri

Aşağıdaki seçenekler, bir komut veya çalıştırılacak bir uygulama belirtmeden tek başına kullanıldığında kullanılabilir dotnet . Örneğin, dotnet --info veya dotnet --version. Ortamla ilgili bilgileri yazdırır.

  • --info

    .NET yüklemesi ve makine ortamı hakkında geçerli işletim sistemi ve .NET sürümünün IŞLEME SHA'sı gibi ayrıntılı bilgileri yazdırır.

  • --version

Komutlar tarafından dotnet kullanılan ve global.json dosyasından etkilenebilen .NET SDK sürümünü yazdırır. Yalnızca SDK yüklendiğinde kullanılabilir.

  • --list-runtimes [--arch <ARCH>]

    Çağrılan dotnetöğesinin mimarisi için yüklü .NET çalışma zamanlarının listesini yazdırır. Listelerin dotnet x86 sürümü yalnızca x86 çalışma zamanları ve listelerin dotnet x64 sürümü yalnızca x64 çalışma zamanları.

    .NET 10 ve sonraki sürümleri bağımsız değişkeni destekler --arch . Belirtilmişse ve mimariyle dotnet aynı değilse, belirtilen mimarinin .NET yüklemesini arar ve orada yüklü tüm çalışma zamanlarını yazdırır. İzin verilen değerler arm64, x64 ve x86'dır. dotnet/runtime deposu geçerli mimari değerlerinin tam listesine sahiptir.

  • --list-sdks [--arch <ARCH>]

    Çağrılan dotnetöğesinin mimarisi için yüklü .NET SDK'larının listesini yazdırır. Listelerin dotnet x86 sürümü yalnızca x86 SDK'lar ve listelerin dotnet x64 sürümü yalnızca x64 SDK'lar.

    .NET 10 ve sonraki sürümleri bağımsız değişkeni destekler --arch . Belirtilirse ve mimariyle dotnet aynı değilse, belirtilen mimarinin .NET yüklemesini arar ve orada yüklü sdk'ları yazdırır. İzin verilen değerler arm64, x64 ve x86'dır. dotnet/runtime deposu geçerli mimari değerlerinin tam listesine sahiptir.

  • -?|-h|--help

    Kullanılabilir komutların listesini yazdırır.

Komut çalıştırma seçenekleri

Aşağıdaki seçenekler bir komutla için dotnet geçerlidir. Örneğin, dotnet build --help veya dotnet build --verbosity diagnostic.

  • -d|--diagnostics

    Tanılama çıkışını etkinleştirir.

  • -v|--verbosity <LEVEL>

    Komutun ayrıntı düzeyini ayarlar. İzin verilen değerler , q[uiet], m[inimal], n[ormal]ve d[etailed]diag[nostic]. Her komutta desteklenmez. Bu seçeneğin kullanılabilir olup olmadığını belirlemek için belirli komut sayfasına bakın.

  • -?|-h|--help

    Belirli bir komutun belgelerini yazdırır. Örneğin, dotnet build --help komutu için build yardım görüntüler.

  • command options

    Her komut, bu komuta özgü seçenekleri tanımlar. Kullanılabilir seçeneklerin listesi için belirli komut sayfasına bakın.

Uygulama çalıştırma seçenekleri

Bir uygulama çalıştırıldığında dotnet aşağıdaki seçenekler kullanılabilir. Örneğin, dotnet --roll-forward Major myapp.dll.

  • --additionalprobingpath <PATH>

    Yoklama ilkesini ve yoklama derlemelerini içeren yol. Birden çok yol belirtmek için seçeneği yineleyin.

  • --additional-deps <PATH>

    Ek bir .deps.jsondosyasının yolu. deps.json dosyası, derleme çakışmalarını gidermek için kullanılan bağımlılıkların, derleme bağımlılıklarının ve sürüm bilgilerinin listesini içerir. Daha fazla bilgi için bkz. GitHub#B0 da Çalışma Zamanı Yapılandırma Dosyaları #C1.

  • --roll-forward <SETTING>

    Uygulamaya ileri sarmanın nasıl uygulanacağını denetler. SETTING aşağıdaki değerlerden biri olabilir. Belirtilmezse, Minor varsayılan değerdir.

    • LatestPatch - En yüksek yama sürümüne ilerleyin. Bu, ikincil sürümü ileri sarmayı devre dışı bırakır.
    • Minor - İstenen ikincil sürüm eksikse en düşük daha yüksek ikincil sürüme ilerleyin. İstenen ikincil sürüm varsa, LatestPatch ilkesi kullanılır.
    • Major - İstenen ana sürüm eksikse en düşük yüksek ana sürüme ve en düşük ikincil sürüme ileri doğru ilerleyin. İstenen ana sürüm mevcutsa İkincil ilke kullanılır.
    • LatestMinor - İstenen ikincil sürüm mevcut olsa bile en yüksek ikincil sürüme ilerleyin. Bileşen barındırma senaryolarına yöneliktir.
    • LatestMajor - İstenen ana dal mevcut olsa bile en yüksek ana ve en yüksek ikincil sürüme ilerleyin. Bileşen barındırma senaryolarına yöneliktir.
    • Disable - İleri gitme. Yalnızca belirtilen sürüme bağlayın. Bu ilke, en son düzeltme eklerine ileri gitme özelliğini devre dışı bırakacağından genel kullanım için önerilmez. Bu değer yalnızca test için önerilir.

    dışında Disable, tüm ayarlar kullanılabilir en yüksek düzeltme eki sürümünü kullanır.

    İleri sarma davranışı bir proje dosyası özelliğinde, çalışma zamanı yapılandırma dosyası özelliğinde ve ortam değişkeninde de yapılandırılabilir. Daha fazla bilgi için bkz. Ana sürüm çalışma zamanı ileri sarma.

  • --fx-version <VERSION>

    Uygulamayı çalıştırmak için kullanılacak .NET çalışma zamanının sürümü.

    Bu seçenek, uygulamanın .runtimeconfig.json dosyasındaki ilk çerçeve başvurusunun sürümünü geçersiz kılar. Bu, yalnızca bir çerçeve başvurusu varsa beklendiği gibi çalıştığı anlamına gelir. Uygulamanın birden fazla çerçeve başvurusu varsa, bu seçeneğin kullanılması hatalara neden olabilir.

Komutuyla exec uygulama çalıştırma seçenekleri

Aşağıdaki seçenekler yalnızca komutu kullanılarak dotnet bir uygulama çalıştırıldığında exec kullanılabilir. Örneğin, dotnet exec --runtimeconfig myapp.runtimeconfig.json myapp.dll.

  • --depsfile <PATH>

    deps.json dosyasının yolu. deps.json dosyası, uygulamayı çalıştırmak için gereken bağımlılıklar hakkında bilgi içeren bir yapılandırma dosyasıdır. Bu dosya .NET SDK tarafından oluşturulur.

  • --runtimeconfig <PATH>

    runtimeconfig.json dosyasının yolu. runtimeconfig.json dosyası çalışma zamanı ayarlarını içerir ve genellikle .runtimeconfig.jsonapplicationname< olarak adlandırılır>. Daha fazla bilgi için bakınız .NET çalışma zamanı yapılandırma ayarları.

dotnet komutları

Genel

Komut İşlev
dotnet derleme .NET uygulaması oluşturur.
dotnet build-server Bir derleme tarafından başlatılan sunucularla etkileşim kurar.
dotnet clean Derleme çıkışlarını temizleyin.
dotnet exec Bir .NET uygulaması çalıştırır.
dotnet yardımı Komutun çevrimiçi olarak daha ayrıntılı belgelerini gösterir.
dotnet geçişi Geçerli bir Preview 2 projesini .NET Core SDK 1.0 projesine geçirir.
dotnet msbuild MSBuild komut satırına erişim sağlar.
dotnet new Belirli bir şablon için bir C# veya F# projesi başlatır.
dotnet pack Kodunuzun NuGet paketini oluşturur.
dotnet publish .NET framework'e bağımlı veya bağımsız bir uygulama yayımlar.
dotnet restore Belirli bir uygulamanın bağımlılıklarını geri yükler.
dotnet run Uygulamayı kaynaktan çalıştırır.
dotnet sdk denetimi Yüklü SDK ve Çalışma Zamanı sürümlerinin up-totarih durumunu gösterir.
dotnet sln Çözüm dosyasına proje ekleme, kaldırma ve listeleme seçenekleri.
dotnet store Derlemeleri çalışma zamanı paket deposunda depolar.
dotnet testi Test çalıştırıcısı kullanarak testleri çalıştırır.

Proje referansları

Komut İşlev
dotnet reference add komutunu kullanın Proje başvurusu ekler.
dotnet başvuru listesi Proje başvurularını listeler.
dotnet başvurusu kaldırma Proje başvurularını kaldırır.

NuGet paketleri

Komut İşlev
dotnet package add NuGet paketi ekler.
dotnet paket listesi NuGet paketlerini listeler.
dotnet paketini kaldır NuGet paketini kaldırır.
dotnet package search NuGet paketi arar.

NuGet komutları

Komut İşlev
dotnet nuget delete Bir paketi sunucudan siler veya listeden kaldırır.
dotnet nuget push Bir paketi sunucuya gönderir ve yayımlar.
dotnet nuget locals http-istek önbelleği, geçici önbellek veya makine genelinde genel paketler klasörü gibi yerel NuGet kaynaklarını temizler veya listeler.
dotnet nuget add source NuGet kaynağı ekler.
dotnet nuget disable source NuGet kaynağını devre dışı bırakır.
dotnet nuget enable source NuGet kaynağını etkinleştirir.
dotnet nuget list source Yapılandırılmış tüm NuGet kaynaklarını listeler.
dotnet nuget remove source NuGet kaynağını kaldırır.
dotnet nuget güncelleştirme kaynağı NuGet kaynağını güncelleştirir.

İş yükü komutları

Komut İşlev
dotnet iş yükü yükleme İsteğe bağlı bir iş yükü yükler.
dotnet iş yükü listesi Yüklü tüm iş yüklerini listeler.
dotnet iş yükü onarımı Yüklü tüm iş yüklerini onarir.
dotnet iş yükü araması Seçili iş yüklerini veya tüm kullanılabilir iş yüklerini listeleyin.
dotnet iş yükü kaldırma bir iş yükünü kaldırır.
dotnet iş yükü güncelleştirmesi Yüklü tüm iş yüklerini yeniden yükler.

Genel, araç yolu ve yerel araçlar komutları

Araçlar, NuGet paketlerinden yüklenen ve komut isteminden çağrılan konsol uygulamalarıdır. Araçları kendiniz yazabilir veya üçüncü taraflar tarafından yazılan araçları yükleyebilirsiniz. Araçlar genel araçlar, araç yolu araçları ve yerel araçlar olarak da bilinir. Daha fazla bilgi için bkz. .NET araçlarına genel bakış.

Komut İşlev
dotnet tool install Makinenize bir araç yükler.
dotnet araç listesi Makinenizde yüklü olan tüm genel, araç yolu veya yerel araçları listeler.
dotnet araç araması NuGet.org adlarında veya meta verilerinde belirtilen arama terimine sahip araçları arar.
dotnet tool uninstall Makinenizden bir aracı kaldırır.
dotnet araç güncelleştirmesi Makinenizde yüklü olan bir aracı güncelleştirir.

Ek araçlar

.NET SDK'sının bir parçası olarak aşağıdaki ek araçlar kullanılabilir:

Araç İşlev
dev-certs Geliştirme sertifikalarını oluşturur ve yönetir.
Ef Entity Framework Core komut satırı araçları.
kullanıcı gizli dizileri Geliştirme kullanıcı gizli dizilerini yönetir.
bakmak Kaynak koddaki değişiklikleri algıladığında uygulamayı yeniden başlatan veya sık erişimli olarak yeniden yükleyen bir dosya izleyicisi.

Her araç hakkında daha fazla bilgi için yazın dotnet <tool-name> --help.

Örnekler

Yeni bir .NET konsol uygulaması oluşturun:

dotnet new console

Belirli bir dizinde proje ve bağımlılıkları oluşturun:

dotnet build

Uygulama çalıştırma:

dotnet exec myapp.dll

dotnet myapp.dll

Ayrıca bkz.