Aracılığıyla paylaş

dotnet komutu

  • Makale

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

Name

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] [--additional-deps <PATH>]
    [--depsfile <PATH>]
    [--fx-version <VERSION>]  [--roll-forward <SETTING>]
    [--runtimeconfig <PATH>]
    <PATH_TO_APPLICATION> [arguments]

Description

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ını ç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.
  • Uygulama ç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 olabilir. Ortamla ilgili bilgileri yazdırır.

  • --info

    Geçerli işletim sistemi ve .NET sürümünün IŞLEME SHA'sı gibi bir .NET yüklemesi ve makine ortamı hakkında 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

    Yüklü .NET çalışma zamanlarının listesini yazdırır. SDK'nın x86 sürümü yalnızca x86 çalışma zamanlarını listelerken, SDK'nın x64 sürümü yalnızca x64 çalışma zamanlarını listeler.

  • --list-sdks

    Yüklü .NET SDK'larının listesini yazdırır.

  • -?|-h|--help

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

Komut çalıştırma seçenekleri

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

  • -d|--diagnostics

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

  • -v|--verbosity <LEVEL>

    Komutun ayrıntı düzeyini ayarlar. İzin verilen değerler , , m[inimal]n[ormal], d[etailed]ve diag[nostic]değerleridirq[uiet]. 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 komut için belgeleri 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.json dosyası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'da Çalışma Zamanı Yapılandırma Dosyaları .

  • --roll-forward <SETTING>

    İleri sarmanın uygulamaya 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 ileri doğru ilerleyin. Bu, ikincil sürümü ileri sarmayı devre dışı bırakır.
    • Minor - İstenilen ikincil sürüm eksikse en düşük daha yüksek ikincil sürüme ileri doğru 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 sarma. İstenen ana sürüm varsa İkincil ilkesi kullanılır.
    • LatestMinor - İstenen ikincil sürüm mevcut olsa bile en yüksek ikincil sürüme ileri doğru ilerleyin. Bileşen barındırma senaryoları için tasarlanmıştır.
    • LatestMajor - İstenen ana sürüm mevcut olsa bile en yüksek ana ve en yüksek ikincil sürüme ilerleyin. Bileşen barındırma senaryoları için tasarlanmıştır.
    • 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 bir 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 komutunu kullanarak exec bir uygulama çalıştırıldığında dotnet 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 applicationname.runtimeconfig.json> olarak adlandırılır<. Daha fazla bilgi için bkz. .NET çalışma zamanı yapılandırma ayarları.

dotnet komutları

Genel

Komut İşlev
dotnet build Bir .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 help Komutun daha ayrıntılı belgelerini çevrimiçi olarak gösterir.
dotnet migrate 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 uygulama için bağımlılıkları geri yükler.
dotnet run Uygulamayı kaynaktan çalıştırır.
dotnet sdk denetimi Yüklü SDK ve Çalışma Zamanı sürümlerinin güncel 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 test Testleri bir test çalıştırıcısı kullanarak çalıştırır.

Proje başvuruları

Komut İşlev
dotnet add reference Proje başvurusu ekler.
dotnet list reference Proje başvurularını listeler.
dotnet remove reference Proje başvurularını kaldırır.

NuGet paketleri

Komut İşlev
dotnet add package NuGet paketi ekler.
dotnet remove package NuGet paketini kaldırır.

NuGet komutları

Komut İşlev
dotnet nuget delete Bir paketi sunucudan siler veya listeden kaldırır.
dotnet nuget push Bir paketi sunucuya göndererek yayımlar.
dotnet nuget locals http-request ö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 update source NuGet kaynağı Güncelleştirmeler.

İş 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 Tüm yüklü 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ünü kaldırma bir iş yükünü kaldırır.
dotnet iş yükü güncelleştirmesi Tüm yüklü 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 tool list Makinenizde yüklü olan tüm genel, araç yolu veya yerel araçları listeler.
dotnet tool search Adında veya meta verilerinde belirtilen arama terimine sahip araçlar için arama NuGet.org.
dotnet tool uninstall Makinenizden bir aracı kaldırır.
dotnet tool update Makinenizde yüklü bir araç Güncelleştirmeler.

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