Delen via

Overzicht van .NET CLI

Dit artikel is van toepassing op: ✔️ .NET Core 3.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 installeren voor meer informatie over het installeren van de .NET SDK. Nadat u de SDK hebt geïnstalleerd, kunt u CLI-opdrachten uitvoeren door een terminal te openen en de opdrachten in te voeren bij de terminalprompt.

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. De volgende opdrachten worden weergegeven wanneer de console-app is uitgevoerd vanuit een map met de naam my_app:

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

Chauffeur

Het stuurprogramma heeft de naam dotnet en heeft twee verantwoordelijkheden: het uitvoeren van een frameworkafhankelijke app of het uitvoeren van een opdracht.

Als u een frameworkafhankelijke app wilt uitvoeren, geeft u het pad op naar het .dll-bestand van de app na het stuurprogramma zonder bijvoorbeeld dotnet /path/to/my_app.dlleen opdracht op te geven. Wanneer u de opdracht uitvoert vanuit de map waarin het DLL-bestand van de app zich bevindt, hoeft u alleen maar uit te voeren dotnet my_app.dll. Zie de opdracht dotnet voor meer informatie.

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

dotnet build

Eerst bepaalt het stuurprogramma de versie van de SDK die moet worden gebruikt. Als er geen global.json bestand is, wordt de nieuwste versie van de BESCHIKBARE SDK gebruikt. Nadat de SDK-versie is bepaald, wordt de opdracht uitgevoerd.

Opdracht

Met de opdracht wordt een actie uitgevoerd. dotnet build bouwt bijvoorbeeld code. dotnet publish publiceert code. Zie de sectie CLI-opdrachten voor een lijst met opdrachten.

Argumenten

De argumenten die u op de opdrachtregel doorgeeft, zijn de argumenten voor de opdracht die wordt aangeroepen of aan opties die zijn opgegeven met de 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 bijbehorende waarde van het /build_output argument doorgegeven aan de publish opdracht.

CLI-opdrachten

De volgende opdrachten zijn standaard geïnstalleerd:

Basisopdrachten

Opdrachten voor projectwijziging

NuGet-opdrachten

Opdrachten voor workloadbeheer

Geavanceerde opdrachten

Opdrachten voor hulpprogrammabeheer

Hulpprogramma's zijn consoletoepassingen die zijn geïnstalleerd vanuit NuGet-pakketten en worden aangeroepen vanaf 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, gereedschapspadhulpprogramma's en lokale hulpprogramma's genoemd. Zie .NET-hulpprogramma's overzicht voor meer informatie.

Zie ook