dotnet-kommando
Den här artikeln gäller för: ✔️ .NET Core 3.1 SDK och senare versioner
Name
dotnet
– Den allmänna drivrutinen för .NET CLI.
Synopsis
Så här hämtar du information om tillgängliga kommandon och miljön:
dotnet [--version] [--info] [--list-runtimes] [--list-sdks]
dotnet -h|--help
Så här kör du ett kommando (kräver SDK-installation):
dotnet <COMMAND> [-d|--diagnostics] [-h|--help] [--verbosity <LEVEL>]
[command-options] [arguments]
Så här kör du ett program:
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
Kommandot dotnet
har två funktioner:
Den innehåller kommandon för att arbeta med .NET-projekt.
Skapar till exempel
dotnet build
ett projekt. Varje kommando definierar sina egna alternativ och argument. Alla kommandon stöder--help
alternativet för att skriva ut kort dokumentation om hur du använder kommandot.Den kör .NET-program.
Du anger sökvägen till en programfil
.dll
för att köra programmet. Att köra programmet innebär att hitta och köra startpunkten, vilket i fallet med konsolappar ärMain
metoden . Kör till exempeldotnet myapp.dll
programmetmyapp
. Mer information om distributionsalternativ finns i Distribution av .NET-program .
Alternativ
Det finns olika alternativ för:
- Visar information om miljön.
- Köra ett kommando.
- Köra ett program.
Alternativ för att visa miljöinformation och tillgängliga kommandon
Följande alternativ är tillgängliga när dotnet
de används av sig själv, utan att ange ett kommando eller ett program som ska köras. Exempel: dotnet --info
eller dotnet --version
. De skriver ut information om miljön.
--info
Skriver ut detaljerad information om en .NET-installation och datormiljön, till exempel det aktuella operativsystemet, och incheckning av SHA för .NET-versionen.
--version
Skriver ut den version av .NET SDK som används av dotnet
kommandon, som kan påverkas av en global.json-fil . Endast tillgängligt när SDK:et är installerat.
--list-runtimes
Skriver ut en lista över installerade .NET-körningar. En x86-version av SDK visar endast x86-körningar, och en x64-version av SDK visar endast x64-körningar.
--list-sdks
Skriver ut en lista över installerade .NET SDK:er.
-?|-h|--help
Skriver ut en lista över tillgängliga kommandon.
Alternativ för att köra ett kommando
Följande alternativ gäller för dotnet
med ett kommando. Exempel: dotnet build --help
eller dotnet build --verbosity diagnostic
.
-d|--diagnostics
Aktiverar diagnostiska utdata.
-v|--verbosity <LEVEL>
Anger kommandots detaljnivå. Tillåtna värden är
q[uiet]
,m[inimal]
,n[ormal]
,d[etailed]
ochdiag[nostic]
. Stöds inte i alla kommandon. Se den specifika kommandosidan för att avgöra om det här alternativet är tillgängligt.-?|-h|--help
Skriver ut dokumentation för ett visst kommando. Visar till exempel
dotnet build --help
hjälp förbuild
kommandot.command options
Varje kommando definierar alternativ som är specifika för det kommandot. En lista över tillgängliga alternativ finns på den specifika kommandosidan.
Alternativ för att köra ett program
Följande alternativ är tillgängliga när dotnet
du kör ett program. Till exempel dotnet --roll-forward Major myapp.dll
.
--additionalprobingpath <PATH>
Sökväg som innehåller avsökningsprincip och sammansättningar för avsökning. Upprepa alternativet för att ange flera sökvägar.
--additional-deps <PATH>
Sökväg till ytterligare en .deps.json-fil . En deps.json-fil innehåller en lista över beroenden, kompileringsberoenden och versionsinformation som används för att hantera sammansättningskonflikter. Mer information finns i Körningskonfigurationsfiler på GitHub.
--roll-forward <SETTING>
Styr hur vidarebefordrad distribution tillämpas på appen.
SETTING
kan vara ett av följande värden. Om inget angesMinor
är standardvärdet.LatestPatch
– Gå vidare till den högsta korrigeringsversionen. Detta inaktiverar delversionsfördrullning.Minor
– Gå vidare till den lägsta högre delversionen om den begärda delversionen saknas. Om den begärda delversionen finns används LatestPatch-principen.Major
– Gå vidare till den lägsta högre huvudversionen och den lägsta delversionen om den begärda högre versionen saknas. Om den begärda huvudversionen finns används delprincipen.LatestMinor
– Gå vidare till den högsta delversionen, även om den begärda delversionen finns. Avsedd för scenarier för komponentvärdar.LatestMajor
– Gå vidare till högsta högre och högsta delversion, även om den begärda huvudversionen finns. Avsedd för scenarier för komponentvärdar.Disable
- Rulla inte framåt. Bind endast till angiven version. Den här principen rekommenderas inte för allmän användning eftersom den inaktiverar möjligheten att vidarebefordra till de senaste korrigeringarna. Det här värdet rekommenderas endast för testning.
Med undantag
Disable
för använder alla inställningar den högsta tillgängliga korrigeringsversionen.Beteendet för vidarebefordran kan också konfigureras i en projektfilegenskap, en körningskonfigurationsfilegenskap och en miljövariabel. Mer information finns i Runtime-distribution av högre version.
--fx-version <VERSION>
Version av .NET-körningen som ska användas för att köra programmet.
Det här alternativet åsidosätter versionen av den första ramverksreferensen i programmets
.runtimeconfig.json
-fil. Det innebär att det bara fungerar som förväntat om det bara finns en ramverksreferens. Om programmet har fler än en ramverksreferens kan det orsaka fel med det här alternativet.
Alternativ för att köra ett program med exec
kommandot
Följande alternativ är endast tillgängliga när dotnet
kör ett program med hjälp exec
av kommandot . Till exempel dotnet exec --runtimeconfig myapp.runtimeconfig.json myapp.dll
.
--depsfile <PATH>
Sökväg till en deps.json-fil . En deps.json-fil är en konfigurationsfil som innehåller information om beroenden som krävs för att köra programmet. Den här filen genereras av .NET SDK.
--runtimeconfig <PATH>
Sökväg till en runtimeconfig.json-fil . En runtimeconfig.json-fil innehåller körningsinställningar och heter <vanligtvis applicationname.runtimeconfig.json>. Mer information finns i Konfigurationsinställningar för .NET-körning.
dotnet-kommandon
Allmänt
Kommando | Funktion |
---|---|
dotnet-version | Skapar ett .NET-program. |
dotnet build-server | Interagerar med servrar som startas av ett bygge. |
dotnet clean | Rensa build-utdata. |
dotnet exec | Kör ett .NET-program. |
dotnet-hjälp | Visar mer detaljerad dokumentation online för kommandot. |
dotnet migrate | Migrerar ett giltigt förhandsversion 2-projekt till ett .NET Core SDK 1.0-projekt. |
dotnet msbuild | Ger åtkomst till MSBuild-kommandoraden. |
dotnet new | Initierar ett C#- eller F#-projekt för en viss mall. |
dotnet pack | Skapar ett NuGet-paket med din kod. |
dotnet publish | Publicerar ett .NET-ramverksberoende eller självständigt program. |
dotnet-återställning | Återställer beroendena för ett visst program. |
dotnet run | Kör programmet från källan. |
dotnet sdk check | Visar aktuell status för installerade SDK- och Runtime-versioner. |
dotnet sln | Alternativ för att lägga till, ta bort och lista projekt i en lösningsfil. |
dotnet store | Lagrar sammansättningar i runtime-paketarkivet. |
dotnet-test | Kör tester med hjälp av en testkörare. |
Projektreferenser
Kommando | Funktion |
---|---|
dotnet add reference | Lägger till en projektreferens. |
dotnet-listreferens | Visar en lista över projektreferenser. |
dotnet remove-referens | Tar bort en projektreferens. |
NuGet-paket
Kommando | Funktion |
---|---|
dotnet add package | Lägger till ett NuGet-paket. |
dotnet remove-paket | Tar bort ett NuGet-paket. |
NuGet-kommandon
Kommando | Funktion |
---|---|
dotnet nuget delete | Tar bort eller avlistar ett paket från servern. |
dotnet nuget push | Push-överför ett paket till servern och publicerar det. |
dotnet nuget locals | Rensar eller listar lokala NuGet-resurser som http-request-cache, tillfällig cache eller mapp för globala paket för hela datorn. |
dotnet nuget add source | Lägger till en NuGet-källa. |
dotnet nuget disable source | Inaktiverar en NuGet-källa. |
dotnet nuget enable source | Aktiverar en NuGet-källa. |
dotnet nuget list source | Visar en lista över alla konfigurerade NuGet-källor. |
dotnet nuget remove source | Tar bort en NuGet-källa. |
dotnet nuget-uppdateringskälla | Uppdateringar en NuGet-källa. |
Arbetsbelastningskommandon
Kommando | Funktion |
---|---|
installation av dotnet-arbetsbelastning | Installerar en valfri arbetsbelastning. |
lista över dotnet-arbetsbelastningar | Visar en lista över alla installerade arbetsbelastningar. |
reparation av dotnet-arbetsbelastning | Reparerar alla installerade arbetsbelastningar. |
dotnet-arbetsbelastningssökning | Visa en lista över valda arbetsbelastningar eller alla tillgängliga arbetsbelastningar. |
avinstallera dotnet-arbetsbelastning | Avinstallerar en arbetsbelastning. |
dotnet-arbetsbelastningsuppdatering | Installerar om alla installerade arbetsbelastningar. |
Kommandon för globala verktyg, verktygsvägar och lokala verktyg
Verktyg är konsolprogram som installeras från NuGet-paket och som anropas från kommandotolken. Du kan skriva verktyg själv eller installera verktyg som skrivits av tredje part. Verktyg kallas även globala verktyg, verktygssökvägsverktyg och lokala verktyg. Mer information finns i Översikt över .NET-verktyg.
Kommando | Funktion |
---|---|
installation av dotnet-verktyget | Installerar ett verktyg på datorn. |
dotnet-verktygslista | Visar en lista över alla globala verktyg, verktygssökvägar eller lokala verktyg som är installerade på datorn. |
sök efter dotnet-verktyg | Söker NuGet.org efter verktyg som har den angivna söktermen i namn eller metadata. |
avinstallation av dotnet-verktyget | Avinstallerar ett verktyg från datorn. |
dotnet tool update | Uppdateringar ett verktyg som är installerat på datorn. |
Fler verktyg
Följande ytterligare verktyg är tillgängliga som en del av .NET SDK:
Verktyg | Funktion |
---|---|
dev-certs | Skapar och hanterar utvecklingscertifikat. |
Ef | Entity Framework Core-kommandoradsverktyg. |
användarhemligheter | Hanterar utvecklingsanvändarhemligheter. |
watch | En filväktare som startar om eller laddar om ett program när det identifierar ändringar i källkoden. |
Om du vill ha mer information om varje verktyg skriver du dotnet <tool-name> --help
.
Exempel
Skapa ett nytt .NET-konsolprogram:
dotnet new console
Skapa ett projekt och dess beroenden i en viss katalog:
dotnet build
Kör ett program:
dotnet exec myapp.dll
dotnet myapp.dll
Se även
Feedback
https://aka.ms/ContentUserFeedback.
Kommer snart: Under hela 2024 kommer vi att fasa ut GitHub-problem som feedbackmekanism för innehåll och ersätta det med ett nytt feedbacksystem. Mer information finns i:Skicka och visa feedback för