dotnet komutu

  • Makale
  • Okumak için 3 dakika

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

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

Komut ç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>]
    [--fx-version <VERSION>]  [--roll-forward <SETTING>]
    <PATH_TO_APPLICATION> [arguments]

--roll-forward , .NET Core 3.x'ten itibaren kullanılabilir. --roll-forward-on-no-candidate-fx.NET Core 2.x için kullanın.

Description

Komutun dotnet iki işlevi vardır:

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

    Örneğin, dotnet build bir proje derleme. Her komut kendi seçeneklerini ve bağımsız değişkenlerini tanımlar. Tüm --help komutlar, komutun kullanımıyla ilgili 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 için giriş noktasını bulup yürütmeniz gerekir. Bu durumda, konsol uygulamaları Main yöntemidir. Örneğin, dotnet myapp.dll uygulamayı myapp çalıştırır. Dağıtım seçenekleri hakkında bilgi edinmek için bkz. .NET uygulama dağıtımı.

Seçenekler

Tek başına, bir dotnet komutu çalıştırmaya ve bir uygulamayı çalıştırmaya için farklı seçenekler kullanılabilir.

Dotnet'in kendisi için seçenekler

Aşağıdaki seçenekler tek dotnet başına içindir. Örneğin, dotnet --info. Ortamla ilgili bilgileri yazdırmaktadır.

  • --info

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

  • --version

dotnet komutları tarafından kullanılan .NET SDK sürümünü yazdırır. Herhangi bir global.json'un etkilerini içerir

  • --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ı, SDK'nın x64 sürümü ise yalnızca x64 çalışma zamanlarını listeler.

  • --list-sdks

    Yüklü .NET SDK'lerinin listesini yazdırır.

  • -?|-h|--help

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

Komut çalıştırmaya için SDK seçenekleri

Aşağıdaki seçenekler dotnet komutuyla içindir. Örneğin, dotnet build --help.

  • -d|--diagnostics

    Tanılama çıkışını sağlar.

  • -v|--verbosity <LEVEL>

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

  • -?|-h|--help

    Gibi bir komutun belgelerini dotnet build --help yazdırır.

  • command options

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

Çalışma zamanı seçenekleri

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

  • --additionalprobingpath <PATH>

    Yoklama ilkesi ve yoklama derlemelerini içeren yol.

  • --additional-deps <PATH>

    Ek bir .deps.json dosyasının yolu. Deps.json dosyası bağımlılıkların, derleme bağımlılıklarının ve derleme çakışmalarını ele almak için kullanılan sürüm bilgilerini içerir. Daha fazla bilgi için bkz. Çalışma Zamanı Yapılandırma Dosyaları GitHub.

  • --depsfile <PATH_TO_DEPSFILE>

    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

    Runtimeconfig.json dosyasının yolu. Runtimeconfig.json dosyası, çalışma zamanı ayarlarını içeren bir yapılandırma dosyasıdır. Daha fazla bilgi için bkz. .NET çalışma zamanı yapılandırma ayarları.

  • **--roll-forward <SETTING>**3.0 .NET Core SDK başlayarak kullanılabilir.

    Uygulamaya ilerlemenin nasıl uygulandığını kontrol eder. SETTINGaşağıdaki değerlerden biri olabilir. Belirtilmezse, Minor varsayılan değerdir.

    • LatestPatch - En yüksek düzeltme eki sürümüne iletin. Bu, ikincil sürüm ileri sarmayı devre dışı bırakıyor.
    • Minor - İstenen ikincil sürüm eksikse en düşük daha yüksek ikincil sürüme inin. İ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 iletin. İstenen ana sürüm varsa, İkincil ilke kullanılır.
    • LatestMinor - İstenen ikincil sürüm mevcut olsa bile en yüksek ikincil sürüme iletin. 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 inin. Bileşen barındırma senaryoları için tasarlanmıştır.
    • Disable - Devam etme. Yalnızca belirtilen sürüme bağlayın. Bu ilke, en son düzeltme eklerini iletme özelliğini devre dışı bırakarak genel kullanım için önerilmez. Bu değer yalnızca test için önerilir.

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

    Geri alma davranışı bir proje dosyası özelliğinde, çalışma zamanı yapılandırma dosyası özelliğinde ve ortam değişkende de yalıtabilirsiniz. Daha fazla bilgi için bkz. Ana sürüm çalışma zamanı ileri sarma.

  • --roll-forward-on-no-candidate-fx <N>****.NET Core 2.x SDK'da kullanılabilir.

    Gerekli paylaşılan çerçeve kullanılabilir olduğunda davranışı tanımlar. N şunları olabilir:

    • 0 - İkincil sürüm ileri sarmayı bile devre dışı bırak.
    • 1 - Ana sürümde değil, ikincil sürümde ileri sarma. Bu varsayılan davranıştır.
    • 2 - İkincil ve ana sürümlerde ileri sarma.

    Daha fazla bilgi için bkz. Ileriye sarma.

    .NET Core 3.0'dan başlayarak, bu seçeneğin yerine kullanılır ve --roll-forward bunun yerine bu seçenek kullanılmalıdır.

  • --fx-version <VERSION>

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

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

dotnet komutları

Genel

Komut İşlev
dotnet build Bir .NET uygulaması derleme.
dotnet build-server Bir yapı tarafından başlatılan sunucularla etkileşime girer.
dotnet clean Derleme çıktılarını temizle.
dotnet help Komutu için çevrimiçi daha ayrıntılı belgeler 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 C# veya F # projesi başlatır.
dotnet pack kodunuzun NuGet paketini oluşturur.
dotnet publish .NET Framework 'e bağımlı veya kendi kendine içerilen 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üklenen SDK ve çalışma zamanı sürümlerinin güncel durumunu gösterir.
dotnet sln Bir çözüm dosyasındaki projeleri 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 Bir proje başvurusu ekler.
dotnet list reference Proje başvurularını listeler.
dotnet remove reference Proje başvurusunu kaldırır.

NuGet paketleri

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

NuGet komutları

Komut İşlev
dotnet nuget delete Sunucudan bir paketi siler veya listesini 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 genelindeki genel paketler klasörü gibi yerel NuGet kaynaklarını temizler veya listeler.
dotnet nuget add source NuGet bir kaynak ekler.
dotnet nuget disable source NuGet kaynağını devre dışı bırakır.
dotnet nuget enable source NuGet kaynağı etkinleştirilir.
dotnet nuget list source tüm yapılandırılmış NuGet kaynaklarını listeler.
dotnet nuget remove source NuGet kaynağını kaldırır.
dotnet nuget update source bir NuGet kaynağını güncelleştirir.

İş yükü komutları

Komut İşlev
DotNet iş yükü yüklemesi İsteğe bağlı bir iş yükü kurar.
DotNet iş yükü listesi Tüm yüklü iş yüklerini listeler.
DotNet iş yükü onarımı Tüm yüklü iş yüklerini onarır.
DotNet iş yükü arama Seçilen 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 Tüm yüklü iş yüklerini yeniden yükler.

Küresel, 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ü taraflarca yazılmış 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ış. Genel ve araç yolu araçları .NET Core SDK 2,1 ' den başlayarak kullanılabilir. Yerel araçlar .NET Core SDK 3,0 ' den başlayarak kullanılabilir.

Komut İşlev
dotnet tool install Makinenize bir araç kurar.
dotnet tool list Makinenizde yüklü olan tüm genel, araç-yol veya yerel araçları listeler.
dotnet tool search adında veya meta verilerinde belirtilen arama terimine sahip araçlar için NuGet. org öğesini arar.
dotnet tool uninstall Bir aracı makinenizden kaldırır.
dotnet tool update Makinenizde yüklü bir aracı güncelleştirir.

Ek araçlar

.NET Core SDK 2.1.300 ile başlayarak, yalnızca DotnetCliToolReference .NET SDK 'sının bir parçası olarak, kullanılarak yalnızca proje bazında kullanılabilen birçok araç mevcuttur. Bu araçlar aşağıdaki tabloda listelenmiştir:

Araç İşlev
geliştirme-CERT Geliştirme sertifikaları oluşturur ve yönetir.
aşv Komut satırı araçlarını Entity Framework Core.
Kullanıcı gizli dizileri Geliştirme Kullanıcı gizli dizilerini yönetir.
Servisi Dosyalar değiştiğinde bir komutu çalıştıran bir dosya İzleyicisi başlatır.

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 bir proje ve onun bağımlılıklarını oluşturun:

dotnet build

Bir uygulamayı çalıştırın:

dotnet myapp.dll

Ayrıca bkz.