Overzicht van .NET CLI

  • Artikel

Dit artikel is van toepassing op: ✔️ .NET Core 2.1 SDK en latere versies

De .NET-opdrachtregelinterface (CLI) is een platformoverschrijdende hulpprogrammaketen voor het ontwikkelen, bouwen, uitvoeren en publiceren van .NET-toepassingen.

De .NET CLI is opgenomen in de .NET SDK. Zie .NET Core installeren voor meer informatie over het installeren van de .NET SDK.

CLI-opdrachten

De volgende opdrachten worden standaard geïnstalleerd:

Basisopdrachten

opdrachten Project wijzigen

Geavanceerde opdrachten

Opdrachten voor hulpprogrammabeheer

Hulpprogramma's zijn consoletoepassingen die zijn geïnstalleerd vanuit NuGet-pakketten en worden aangeroepen vanuit de opdrachtprompt. U kunt zelf hulpprogramma's schrijven of hulpprogramma's installeren die door derden zijn geschreven. Hulpprogramma's worden ook wel globale hulpprogramma's, hulpprogramma's voor hulpprogramma's en lokale hulpprogramma's genoemd. Zie het overzicht van .NET-hulpprogramma's voor meer informatie.

Opdrachtstructuur

De CLI-opdrachtstructuur bestaat uit het stuurprogramma ('dotnet', de opdracht en mogelijk opdrachtargumenten en -opties. U ziet dit patroon in de meeste CLI-bewerkingen, zoals het maken van een nieuwe console-app en het uitvoeren vanaf de opdrachtregel, zoals de volgende opdrachten worden weergegeven wanneer deze worden uitgevoerd vanuit een map met de naam my_app:

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

Stuurprogramma

Het stuurprogramma heet dotnet en heeft twee verantwoordelijkheden, het uitvoeren van een frameworkafhankelijke app of het uitvoeren van een opdracht.

Als u een afhankelijke framework-app wilt uitvoeren, geeft u de app op na het stuurprogramma, dotnet /path/to/my_app.dllbijvoorbeeld. Wanneer u de opdracht uitvoert vanuit de map waarin de DLL van de app zich bevindt, voert u gewoon uit dotnet my_app.dll. Als u een specifieke versie van .NET Runtime wilt gebruiken, gebruikt u de --fx-version <VERSION> optie (zie de dotnet-opdrachtreferentie ).

Wanneer u een opdracht aan het stuurprogramma opgeeft, dotnet.exe start u het uitvoeringsproces van de CLI-opdracht. Bijvoorbeeld:

dotnet build

Ten eerste bepaalt het stuurprogramma de versie van de SDK die moet worden gebruikt. Als er geen global.json-bestand is, wordt de meest recente versie van de BESCHIKBARE SDK gebruikt. Dit kan een preview- of stabiele versie zijn, afhankelijk van wat de meest recente versie op de computer is. Zodra de SDK-versie is bepaald, wordt de opdracht uitgevoerd.

Opdracht

Met de opdracht wordt een actie uitgevoerd. Bouwt bijvoorbeeld dotnet build code. dotnet publish publiceert code. De opdrachten worden geïmplementeerd als een consoletoepassing met behulp van een dotnet {command} conventie.

Argumenten

De argumenten die u op de opdrachtregel doorgeeft, zijn de argumenten voor de aangeroepen opdracht. Wanneer u bijvoorbeeld uitvoert dotnet publish my_app.csproj, geeft het my_app.csproj argument aan dat het project moet worden gepubliceerd en wordt doorgegeven aan de publish opdracht.

Opties

De opties die u op de opdrachtregel doorgeeft, zijn de opties voor de opdracht die wordt aangeroepen. Wanneer u bijvoorbeeld uitvoert dotnet publish --output /build_output, worden de --output optie en de waarde ervan doorgegeven aan de publish opdracht.

Zie ook