Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Dit artikel is van toepassing op: ✔️ .NET Core 3.1 SDK en latere versies
Naam
dotnet
- Het algemene stuurprogramma voor de .NET CLI.
Samenvatting
Voor informatie over de beschikbare opdrachten en de omgeving:
dotnet [--version] [--info] [--list-runtimes] [--list-sdks]
dotnet -h|--help
Een opdracht uitvoeren (vereist SDK-installatie):
dotnet <COMMAND> [-d|--diagnostics] [-h|--help] [--verbosity <LEVEL>]
[command-options] [arguments]
Een toepassing uitvoeren:
dotnet [--additionalprobingpath <PATH>] [--additional-deps <PATH>]
[--fx-version <VERSION>] [--roll-forward <SETTING>]
<PATH_TO_APPLICATION> [arguments]
dotnet exec [--additionalprobingpath <PATH>] [--additional-deps <PATH>]
[--depsfile <PATH>]
[--fx-version <VERSION>] [--roll-forward <SETTING>]
[--runtimeconfig <PATH>]
<PATH_TO_APPLICATION> [arguments]
Beschrijving
De dotnet
opdracht heeft twee functies:
Het biedt opdrachten voor het werken met .NET-projecten.
Hiermee wordt bijvoorbeeld
dotnet build
een project gebouwd. Elke opdracht definieert zijn eigen opties en argumenten. Alle opdrachten ondersteunen de optie voor het--help
afdrukken van korte documentatie over het gebruik van de opdracht.Er worden .NET-toepassingen uitgevoerd.
U geeft het pad op naar een toepassingsbestand
.dll
om de toepassing uit te voeren. Als u de toepassing wilt uitvoeren, moet u het toegangspunt zoeken en uitvoeren, wat in het geval van console-apps deMain
methode is. Voert bijvoorbeelddotnet myapp.dll
demyapp
toepassing uit. Zie .NET-toepassingsimplementatie voor meer informatie over implementatieopties.
Opties
Er zijn verschillende opties beschikbaar voor:
- Informatie over de omgeving weergeven.
- Een opdracht uitvoeren.
- Een toepassing uitvoeren.
Opties voor het weergeven van omgevingsgegevens en beschikbare opdrachten
De volgende opties zijn beschikbaar wanneer dotnet
deze door zichzelf worden gebruikt, zonder een opdracht of toepassing op te geven die moet worden uitgevoerd. Bijvoorbeeld dotnet --info
of dotnet --version
. Ze drukken informatie over de omgeving af.
--info
Geeft gedetailleerde informatie weer over een .NET-installatie en de computeromgeving, zoals het huidige besturingssysteem, en doorvoer SHA van de .NET-versie.
--version
Hiermee wordt de versie van de .NET SDK afgedrukt die wordt gebruikt door dotnet
opdrachten. Dit kan worden beïnvloed door een global.json-bestand . Alleen beschikbaar wanneer de SDK is geïnstalleerd.
--list-runtimes [--arch <ARCH>]
Hiermee wordt een lijst afgedrukt met de geïnstalleerde .NET-runtimes voor de architectuur van de aangeroepen
dotnet
. Een x86-versie vandotnet
lijsten alleen x86-runtimes en een x64-versie vandotnet
lijsten alleen x64-runtimes..NET 10 en latere versies ondersteunen het
--arch
argument. Als deze is opgegeven en niet hetzelfde is als dedotnet
architectuur, zoekt u naar een .NET-installatie van de opgegeven architectuur en worden alle runtimes afgedrukt die daar zijn geïnstalleerd. Toegestane waarden zijn arm64, x64 en x86. De dotnet/runtime-opslagplaats bevat de volledige lijst met geldige architectuurwaarden.--list-sdks [--arch <ARCH>]
Hiermee wordt een lijst afgedrukt met de geïnstalleerde .NET SDK's voor de architectuur van de aangeroepen
dotnet
. Een x86-versie vandotnet
lijsten alleen x86 SDK's en een x64-versie vandotnet
lijsten alleen x64 SDK's..NET 10 en latere versies ondersteunen het
--arch
argument. Als deze is opgegeven en niet hetzelfde is als dedotnet
architectuur, zoekt u naar een .NET-installatie van de opgegeven architectuur en drukt u alle DAAR geïnstalleerde SDK's af. Toegestane waarden zijn arm64, x64 en x86. De dotnet/runtime-opslagplaats bevat de volledige lijst met geldige architectuurwaarden.-?|-h|--help
Hiermee wordt een lijst met beschikbare opdrachten afgedrukt.
Opties voor het uitvoeren van een opdracht
De volgende opties zijn bedoeld voor dotnet
een opdracht. Bijvoorbeeld dotnet build --help
of dotnet build --verbosity diagnostic
.
-d|--diagnostics
Hiermee schakelt u diagnostische uitvoer in.
-v|--verbosity <LEVEL>
Hiermee stelt u het uitgebreidheidsniveau van de opdracht in. Toegestane waarden zijn
q[uiet]
, , ,m[inimal]
enn[ormal]
d[etailed]
diag[nostic]
. Niet ondersteund in elke opdracht. Zie de specifieke opdrachtpagina om te bepalen of deze optie beschikbaar is.-?|-h|--help
Hiermee wordt documentatie afgedrukt voor een bepaalde opdracht. Geeft bijvoorbeeld
dotnet build --help
help weer voor debuild
opdracht.command options
Elke opdracht definieert opties die specifiek zijn voor die opdracht. Zie een specifieke opdrachtpagina voor een lijst met beschikbare opties.
Opties voor het uitvoeren van een toepassing
De volgende opties zijn beschikbaar wanneer dotnet
een toepassing wordt uitgevoerd. Bijvoorbeeld: dotnet --roll-forward Major myapp.dll
.
--additionalprobingpath <PATH>
Pad met testbeleid en assembly's. Herhaal de optie om meerdere paden op te geven.
--additional-deps <PATH>
Pad naar een extra .deps.json-bestand . Een deps.json-bestand bevat een lijst met afhankelijkheden, compilatieafhankelijkheden en versie-informatie die wordt gebruikt om assemblyconflicten te verhelpen. Zie Runtime-configuratiebestanden op GitHub voor meer informatie.
--roll-forward <SETTING>
Hiermee bepaalt u hoe roll forward wordt toegepast op de app. Dit
SETTING
kan een van de volgende waarden zijn. Als dit niet is opgegeven,Minor
is dit de standaardwaarde.-
LatestPatch
- Doorsturen naar de hoogste patchversie. Hierdoor wordt het terugdraaien van secundaire versies uitgeschakeld. - #D0: rol door naar de laagste hogere secundaire versie als de aangevraagde secundaire versie ontbreekt. Als de aangevraagde secundaire versie aanwezig is, wordt het LatestPatch-beleid gebruikt.
- #D0: rol door naar de laagste hogere primaire versie en de laagste secundaire versie als de aangevraagde primaire versie ontbreekt. Als de aangevraagde primaire versie aanwezig is, wordt het secundaire beleid gebruikt.
-
LatestMinor
- Rol door naar de hoogste secundaire versie, zelfs als de aangevraagde secundaire versie aanwezig is. Bedoeld voor scenario's voor het hosten van onderdelen. -
LatestMajor
- Rol door naar de hoogste primaire en hoogste secundaire versie, zelfs als de aangevraagde primaire versie aanwezig is. Bedoeld voor scenario's voor het hosten van onderdelen. -
Disable
- Ga niet vooruit. Alleen binden aan de opgegeven versie. Dit beleid wordt niet aanbevolen voor algemeen gebruik, omdat hiermee de mogelijkheid om door te schakelen naar de nieuwste patches wordt uitgeschakeld. Deze waarde wordt alleen aanbevolen voor testen.
Met uitzondering van
Disable
alle instellingen wordt de meest beschikbare patchversie gebruikt.Gedrag voor doorsturen kan ook worden geconfigureerd in een eigenschap van een projectbestand, een eigenschap van een runtime-configuratiebestand en een omgevingsvariabele. Zie De runtime-roll forward van de primaire versie voor meer informatie.
-
--fx-version <VERSION>
Versie van de .NET-runtime die moet worden gebruikt om de toepassing uit te voeren.
Met deze optie wordt de versie van de eerste frameworkreferentie in het #D0-bestand van de toepassing overschreven. Dit betekent dat het alleen werkt zoals verwacht als er slechts één frameworkreferentie is. Als de toepassing meer dan één frameworkreferentie heeft, kan het gebruik van deze optie fouten veroorzaken.
Opties voor het uitvoeren van een toepassing met de exec
opdracht
De volgende opties zijn alleen beschikbaar wanneer dotnet
een toepassing wordt uitgevoerd met behulp van de exec
opdracht. Bijvoorbeeld: dotnet exec --runtimeconfig myapp.runtimeconfig.json myapp.dll
.
--depsfile <PATH>
Pad naar een deps.json-bestand . Een deps.json-bestand is een configuratiebestand dat informatie bevat over afhankelijkheden die nodig zijn om de toepassing uit te voeren. Dit bestand wordt gegenereerd door de .NET SDK.
--runtimeconfig <PATH>
Pad naar een runtimeconfig.json-bestand . Een runtimeconfig.json-bestand bevat runtime-instellingen en heeft meestal de naam van de toepassingsnaam<>.runtimeconfig.json. Zie .NET Runtime-configuratie-instellingenvoor meer informatie.
dotnet-opdrachten
Algemeen
Opdracht | Functie |
---|---|
dotnet-build | Hiermee wordt een .NET-toepassing gebouwd. |
dotnet build-server | Interactie met servers die zijn gestart door een build. |
dotnet schoon | Schone build-uitvoer. |
dotnet exec | Hiermee wordt een .NET-toepassing uitgevoerd. |
dotnet Help | Toont meer gedetailleerde documentatie online voor de opdracht. |
dotnet-migratie | Hiermee migreert u een geldig Preview 2-project naar een .NET Core SDK 1.0-project. |
dotnet msbuild | Biedt toegang tot de MSBuild-opdrachtregel. |
dotnet nieuwe | Initialiseert een C#- of F#-project voor een bepaalde sjabloon. |
dotnet pack | Hiermee maakt u een NuGet-pakket van uw code. |
dotnet publiceren | Hiermee publiceert u een .NET Framework-afhankelijke of zelfstandige toepassing. |
dotnet herstellen | Hiermee worden de afhankelijkheden voor een bepaalde toepassing hersteld. |
dotnet-uitvoering | Hiermee wordt de toepassing vanuit de bron uitgevoerd. |
dotnet sdk-controle | Toont up-to-datumstatus van geïnstalleerde SDK- en Runtime-versies. |
dotnet sln | Opties voor het toevoegen, verwijderen en weergeven van projecten in een oplossingsbestand. |
dotnet store | Slaat assembly's op in het runtime-pakketarchief. |
dotnet-test | Voert tests uit met behulp van een testloper. |
Projectverwijzingen
Opdracht | Functie |
---|---|
dotnet-verwijzing toevoegen | Voegt een projectreferentie toe. |
dotnet-referentielijst | Bevat projectverwijzingen. |
dotnet-verwijzing verwijderen | Hiermee verwijdert u een projectreferentie. |
NuGet-pakketten
Opdracht | Functie |
---|---|
dotnet-pakket toevoegen | Hiermee voegt u een NuGet-pakket toe. |
dotnet-pakketlijst | Hiermee worden NuGet-pakketten weergegeven. |
dotnet-pakket verwijderen | Hiermee verwijdert u een NuGet-pakket. |
zoeken in dotnet-pakketten | Zoekt naar een NuGet-pakket. |
NuGet-opdrachten
Opdracht | Functie |
---|---|
dotnet nuget delete | Hiermee verwijdert of verwijdert u een pakket van de server. |
dotnet nuget push | Pusht een pakket naar de server en publiceert het. |
dotnet nuget locals | Hiermee worden lokale NuGet-resources, zoals http-aanvraagcache, tijdelijke cache of globale pakketmap voor de hele machine, gewist of weergegeven. |
dotnet nuget add source | Hiermee voegt u een NuGet-bron toe. |
dotnet nuget uitschakelen bron | Hiermee schakelt u een NuGet-bron uit. |
dotnet nuget inschakelen bron | Hiermee schakelt u een NuGet-bron in. |
dotnet nuget-lijstbron | Een lijst met alle geconfigureerde NuGet-bronnen. |
dotnet nuget remove source | Hiermee verwijdert u een NuGet-bron. |
dotnet nuget-updatebron | Hiermee wordt een NuGet-bron bijgewerkt. |
Workloadopdrachten
Opdracht | Functie |
---|---|
dotnet-workload installeren | Hiermee wordt een optionele workload geïnstalleerd. |
lijst met dotnet-werkbelastingen | Geeft een lijst weer van alle geïnstalleerde workloads. |
dotnet-workloadherstel | Herstelt alle geïnstalleerde workloads. |
zoeken in dotnet-werkbelasting | Een lijst weergeven met geselecteerde workloads of alle beschikbare workloads. |
dotnet-workload verwijderen | Hiermee verwijdert u een workload. |
dotnet-werkbelasting bijwerken | Installeert alle geïnstalleerde workloads opnieuw. |
Opdrachten voor globale, hulpprogrammapaden en lokale hulpprogramma's
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 algemene hulpprogramma's, hulpprogramma's voor hulpprogramma's en lokale hulpprogramma's genoemd. Zie .NET-hulpprogramma's overzicht voor meer informatie.
Opdracht | Functie |
---|---|
dotnet tool install | Hiermee installeert u een hulpprogramma op uw computer. |
lijst met dotnet-hulpprogramma's | Een lijst met alle algemene, hulpprogrammapaden of lokale hulpprogramma's die momenteel op uw computer zijn geïnstalleerd. |
zoeken in dotnet-hulpprogramma's | Hiermee wordt NuGet.org gezocht naar hulpprogramma's met de opgegeven zoekterm in hun naam of metagegevens. |
dotnet-hulpprogramma verwijderen | Hiermee verwijdert u een hulpprogramma van uw computer. |
dotnet tool update | Hiermee werkt u een hulpprogramma bij dat op uw computer is geïnstalleerd. |
Aanvullende hulpprogramma’s
De volgende extra hulpprogramma's zijn beschikbaar als onderdeel van de .NET SDK:
Werktuig | Functie |
---|---|
dev-certs | Hiermee maakt en beheert u ontwikkelingscertificaten. |
Ef | Entity Framework Core-opdrachtregelprogramma's. |
gebruikersgeheimen | Beheert ontwikkelingsgebruikersgeheimen. |
horloge | Een bestands-watcher die een toepassing opnieuw start of dynamisch laadt wanneer wijzigingen in de broncode worden gedetecteerd. |
Typ voor meer informatie over elk hulpmiddel dotnet <tool-name> --help
.
Voorbeelden
Maak een nieuwe .NET-consoletoepassing:
dotnet new console
Bouw een project en de bijbehorende afhankelijkheden in een bepaalde map:
dotnet build
Een toepassing uitvoeren:
dotnet exec myapp.dll
dotnet myapp.dll