Översikt över .NET CLI

Artikel
09/22/2022

Den här artikeln gäller för: ✔️ .NET Core 2.1 SDK och senare versioner

.NET-kommandoradsgränssnittet (CLI) är en plattformsoberoende verktygskedja för att utveckla, skapa, köra och publicera .NET-program.

.NET CLI ingår i .NET SDK. Information om hur du installerar .NET SDK finns i Installera .NET Core.

CLI-kommandon

Följande kommandon installeras som standard:

Grundläggande kommandon

Project ändringskommandon

Avancerade kommandon

Verktygshanteringskommandon

tool install
tool list
tool update
tool restore Tillgänglig sedan .NET Core SDK 3.0.
tool run Tillgänglig sedan .NET Core SDK 3.0.
tool uninstall

Verktyg är konsolprogram som installeras från NuGet-paket och anropas från kommandotolken. Du kan skriva verktyg själv eller installera verktyg som skrivits av tredje part. Verktyg kallas även globala verktyg, verktygsvägsverktyg och lokala verktyg. Mer information finns i Översikt över .NET-verktyg.

Kommandostruktur

CLI-kommandostrukturen består av drivrutinen ("dotnet"), kommandot och eventuellt kommandoargument och alternativ. Du ser det här mönstret i de flesta CLI-åtgärder, till exempel att skapa en ny konsolapp och köra den från kommandoraden som följande kommandon visar när de körs från en katalog med namnet my_app:

dotnet new console
dotnet build --output ./build_output
dotnet ./build_output/my_app.dll

Drivrutinen

Drivrutinen heter dotnet och har två ansvarsområden, antingen kör en ramverksberoende app eller kör ett kommando.

Om du vill köra en ramverksberoende app anger du appen efter drivrutinen, dotnet /path/to/my_app.dlltill exempel . När du kör kommandot från mappen där appens DLL finns kör dotnet my_app.dlldu bara . Om du vill använda en specifik version av .NET Runtime använder du --fx-version <VERSION> alternativet (se kommandoreferensen för dotnet ).

När du anger ett kommando till drivrutinen dotnet.exe startar cli-kommandokörningsprocessen. Ett exempel:

dotnet build

Först avgör drivrutinen vilken version av SDK som ska användas. Om det inte finns någon global.json-fil används den senaste versionen av SDK:n. Detta kan vara antingen en förhandsversion eller en stabil version, beroende på vad som är senaste på datorn. När SDK-versionen har fastställts kör den kommandot .

Kommando

Kommandot utför en åtgärd. Till dotnet build exempel skapar kod. dotnet publish publicerar kod. Kommandona implementeras som ett konsolprogram med hjälp av en dotnet {command} konvention.

Argument

Argumenten som du skickar på kommandoraden är argumenten till kommandot som anropas. När du till exempel kör dotnet publish my_app.csprojmy_app.csproj anger argumentet det projekt som ska publiceras och skickas publish till kommandot .

Alternativ

De alternativ som du skickar på kommandoraden är alternativen för kommandot som anropas. När du till exempel kör dotnet publish --output /build_outputskickas --output alternativet och dess värde till publish kommandot .

Dela via