dotnet parancs

  • Cikk

Ez a cikk a következő verziókra vonatkozik: ✔️ .NET Core 3.1 SDK és újabb verziók

Name

dotnet – A .NET CLI általános illesztőprogramja.

Áttekintés

Az elérhető parancsokkal és a környezettel kapcsolatos információk lekérése:

dotnet [--version] [--info] [--list-runtimes] [--list-sdks]

dotnet -h|--help

Parancs futtatásához (SDK-telepítés szükséges):

dotnet <COMMAND> [-d|--diagnostics] [-h|--help] [--verbosity <LEVEL>]
    [command-options] [arguments]

Alkalmazás futtatása:

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

A dotnet parancs két függvényt tartalmaz:

  • Parancsokat biztosít a .NET-projektekhez.

    Például dotnet build létrehoz egy projektet. Minden parancs saját beállításokat és argumentumokat határoz meg. Minden parancs támogatja a --help parancs használatával kapcsolatos rövid dokumentáció nyomtatását.

  • .NET-alkalmazásokat futtat.

    Az alkalmazás futtatásához meg kell adnia egy alkalmazásfájl .dll elérési útját. Az alkalmazás futtatásához meg kell keresni és végre kell hajtani a belépési pontot, amely konzolalkalmazások esetén a Main metódus. Futtatja például dotnet myapp.dll az myapp alkalmazást. Az üzembe helyezési lehetőségekről további információt a .NET-alkalmazások üzembe helyezését ismertető cikkben talál.

Beállítások

A következőkhöz különböző lehetőségek érhetők el:

  • A környezettel kapcsolatos információk megjelenítése.
  • Parancs futtatása.
  • Alkalmazás futtatása.

A környezeti információk és az elérhető parancsok megjelenítésének lehetőségei

Az alábbi lehetőségek akkor érhetők el, ha dotnet önmagában használják, anélkül, hogy megadna egy parancsot vagy egy futtatandó alkalmazást. Például dotnet --info vagy dotnet --version. A környezettel kapcsolatos információkat nyomtatják ki.

  • --info

    Részletes információkat nyomtat ki egy .NET-telepítésről és a gépi környezetről, például az aktuális operációs rendszerről, és véglegesíti a .NET-verzió SHA-ját.

  • --version

A parancsok által dotnet használt .NET SDK verzióját nyomtatja ki, amelyet egy global.json fájl érinthet. Csak akkor érhető el, ha az SDK telepítve van.

  • --list-runtimes

    Kinyomtatja a telepített .NET-futtatókörnyezetek listáját. Az SDK x86-os verziója csak az x86-os futtatókörnyezeteket listázza, az SDK x64-es verziója pedig csak az x64-es futtatókörnyezeteket listázza.

  • --list-sdks

    Kinyomtatja a telepített .NET SDK-k listáját.

  • -?|-h|--help

    Kinyomtatja az elérhető parancsok listáját.

Parancs futtatásának lehetőségei

Az alábbi lehetőségek egy paranccsal érhetők dotnet el. Például dotnet build --help vagy dotnet build --verbosity diagnostic.

  • -d|--diagnostics

    Engedélyezi a diagnosztikai kimenetet.

  • -v|--verbosity <LEVEL>

    Beállítja a parancs részletességi szintjét. Az engedélyezett értékek a következők q[uiet]: , m[inimal], n[ormal], d[etailed]és diag[nostic]. Nem támogatott minden parancs. Az adott parancslapon megállapíthatja, hogy elérhető-e ez a lehetőség.

  • -?|-h|--help

    Kiírja egy adott parancs dokumentációját. Megjeleníti például dotnet build --help a parancs súgóját build .

  • command options

    Minden parancs az adott parancsra vonatkozó beállításokat határoz meg. Az elérhető lehetőségek listáját az adott parancslapon tekintheti meg.

Alkalmazások futtatásának lehetőségei

Az alkalmazások futtatásakor dotnet az alábbi lehetőségek érhetők el. Például: dotnet --roll-forward Major myapp.dll.

  • --additionalprobingpath <PATH>

    Próbaszabályzatot és mintavételi szerelvényeket tartalmazó elérési út. Ismételje meg a beállítást több elérési út megadásához.

  • --additional-deps <PATH>

    Egy további .deps.json fájl elérési útja. A deps.json fájl tartalmazza a szerelvényütközések kezelésére használt függőségek, fordítási függőségek és verzióinformációk listáját. További információ: Futtatókörnyezeti konfigurációs fájlok a GitHubon.

  • --roll-forward <SETTING>

    Szabályozza, hogy a roll forward hogyan legyen alkalmazva az alkalmazásra. Az SETTING érték az alábbi értékek egyike lehet. Ha nincs megadva, Minor az alapértelmezett érték.

    • LatestPatch – Ugrás a legmagasabb javítási verzióra. Ez letiltja az alverziók továbbgörgetését.
    • Minor – Ha a kért alverzió hiányzik, lépjen a legalacsonyabb magasabb alverzióra. Ha a kért alverzió jelen van, a rendszer a LatestPatch szabályzatot használja.
    • Major – Lépjen tovább a legalacsonyabb magasabb főverzióra, és a legalacsonyabb alverzióra, ha a kért főverzió hiányzik. Ha a kért főverzió jelen van, a rendszer az Alverzió házirendet használja.
    • LatestMinor – Lépjen tovább a legmagasabb alverzióra, még akkor is, ha a kért alverzió jelen van. Összetevő-üzemeltetési forgatókönyvekhez készült.
    • LatestMajor – Lépjen tovább a legmagasabb főverzióra és a legmagasabb alverzióra, még akkor is, ha a kért főverzió jelen van. Összetevő-üzemeltetési forgatókönyvekhez készült.
    • Disable - Ne lépkedj előre. Csak a megadott verzióhoz kötés. Ez a szabályzat nem ajánlott általános használatra, mert letiltja a legújabb javításokra való váltás lehetőségét. Ez az érték csak teszteléshez ajánlott.

    A kivétellel Disableaz összes beállítás a legmagasabb elérhető javításverziót fogja használni.

    A roll forward viselkedése konfigurálható projektfájl-tulajdonságban, futtatókörnyezet konfigurációs fájltulajdonságában és környezeti változóban is. További információ: Főverziós futtatókörnyezeti visszaállítás.

  • --fx-version <VERSION>

    Az alkalmazás futtatásához használandó .NET-futtatókörnyezet verziója.

    Ez a beállítás felülbírálja az alkalmazás fájljában .runtimeconfig.json található első keretrendszer-referencia verzióját. Ez azt jelenti, hogy csak akkor működik a várt módon, ha csak egy keretrendszerhivatkozás van. Ha az alkalmazás több keretrendszerhivatkozással is rendelkezik, a beállítás használata hibákat okozhat.

Alkalmazások futtatásának lehetőségei a exec paranccsal

A következő lehetőségek csak akkor érhetők el, ha dotnet egy alkalmazást a exec paranccsal futtat. Például: dotnet exec --runtimeconfig myapp.runtimeconfig.json myapp.dll.

  • --depsfile <PATH>

    A deps.json fájl elérési útja. A deps.json fájl egy konfigurációs fájl, amely az alkalmazás futtatásához szükséges függőségekkel kapcsolatos információkat tartalmazza. Ezt a fájlt a .NET SDK hozza létre.

  • --runtimeconfig <PATH>

    Runtimeconfig.json fájl elérési útja. A runtimeconfig.json fájl futásidejű beállításokat tartalmaz, és általában applicationname.runtimeconfig.json> néven szerepel<. További információ: .NET-futtatókörnyezet konfigurációs beállításai.

dotnet-parancsok

Általános kérdések

Parancs Függvény
dotnet build .NET-alkalmazást hoz létre.
dotnet build-server A build által indított kiszolgálókat használja.
dotnet clean Tiszta buildkimenetek.
dotnet exec .NET-alkalmazást futtat.
dotnet súgó Részletesebb dokumentációt jelenít meg az interneten a parancshoz.
dotnet migrálása Érvényes Preview 2-projektet migrál egy .NET Core SDK 1.0-s projektbe.
dotnet msbuild Hozzáférést biztosít az MSBuild parancssorhoz.
dotnet new Inicializál egy C# vagy F# projektet egy adott sablonhoz.
dotnet-csomag Létrehoz egy NuGet-csomagot a kódból.
dotnet publish Közzétesz egy .NET-keretrendszertől függő vagy önálló alkalmazást.
dotnet-visszaállítás Visszaállítja egy adott alkalmazás függőségeit.
dotnet-futtatás Az alkalmazást a forrásból futtatja.
dotnet sdk ellenőrzése A telepített SDK- és futtatókörnyezeti verziók naprakész állapotát jeleníti meg.
dotnet sln A megoldásfájlban lévő projektek hozzáadásának, eltávolításának és listázásának lehetőségei.
dotnet-tároló A szerelvényeket a futtatókörnyezeti csomagtárolóban tárolja.
dotnet-teszt Tesztfuttatóval futtatja a teszteket.

Projekthivatkozások

Parancs Függvény
dotnet – hivatkozás hozzáadása Projekthivatkozás hozzáadása.
dotnet-lista referenciája A projekthivatkozások felsorolása.
dotnet remove reference Eltávolít egy projekthivatkozást.

NuGet-csomagok

Parancs Függvény
dotnet add package Hozzáad egy NuGet-csomagot.
dotnet remove package Eltávolít egy NuGet-csomagot.

NuGet-parancsok

Parancs Függvény
dotnet nuget delete Töröl vagy töröl egy csomagot a kiszolgálóról.
dotnet nuget push Leküld egy csomagot a kiszolgálóra, és közzéteszi azt.
dotnet nuget locals Törli vagy listázza a helyi NuGet-erőforrásokat, például a http-request gyorsítótárat, az ideiglenes gyorsítótárat vagy a gépszintű globális csomagmappát.
dotnet nuget – forrás hozzáadása Hozzáad egy NuGet-forrást.
dotnet nuget – forrás letiltása Letilt egy NuGet-forrást.
dotnet nuget enable source Engedélyezi a NuGet-forrást.
dotnet nuget-lista forrása Felsorolja az összes konfigurált NuGet-forrást.
dotnet nuget – forrás eltávolítása Eltávolít egy NuGet-forrást.
dotnet nuget frissítési forrás Frissítések NuGet-forrást.

Számítási feladatok parancsai

Parancs Függvény
dotnet számítási feladat telepítése Nem kötelező számítási feladatot telepít.
dotnet számítási feladatok listája Felsorolja az összes telepített számítási feladatot.
dotnet számítási feladat javítása Kijavítja az összes telepített számítási feladatot.
dotnet számítási feladatok keresése A kijelölt számítási feladatok vagy az összes elérhető számítási feladat listázása.
dotnet számítási feladat eltávolítása Eltávolít egy számítási feladatot.
dotnet számítási feladat frissítése Újratelepíti az összes telepített számítási feladatot.

Globális, eszközútvonal és helyi eszközök parancsai

Az eszközök a NuGet-csomagokból telepített és a parancssorból meghívott konzolalkalmazások. Saját maga is írhat eszközöket, vagy harmadik felek által írt eszközöket telepíthet. Az eszközöket globális eszközöknek, eszközútvonal-eszközöknek és helyi eszközöknek is nevezik. További információ: .NET-eszközök áttekintése.

Parancs Függvény
dotnet eszköz telepítése Telepít egy eszközt a gépére.
dotnet eszközlista Felsorolja a számítógépen jelenleg telepített összes globális, eszközútvonal- vagy helyi eszközt.
dotnet eszköz keresése Olyan eszközöket keres NuGet.org, amelyek nevében vagy metaadataiban szerepel a megadott keresési kifejezés.
dotnet eszköz eltávolítása Eltávolít egy eszközt a gépről.
dotnet eszközfrissítés Frissítések a számítógépre telepített eszközt.

További eszközök

A .NET SDK részeként a következő további eszközök érhetők el:

Eszköz Függvény
dev-certs Fejlesztési tanúsítványokat hoz létre és kezel.
Ef Entity Framework Core parancssori eszközök.
felhasználói titkos kódok A fejlesztői felhasználói titkos kódokat kezeli.
watch A fájlfigyelő újraindul vagy újra betölt egy alkalmazást, amikor változásokat észlel a forráskódban.

Az egyes eszközökre vonatkozó további információkért írja be a következőt dotnet <tool-name> --help: .

Példák

Hozzon létre egy új .NET-konzolalkalmazást:

dotnet new console

Projekt és függőségeinek létrehozása egy adott könyvtárban:

dotnet build

Alkalmazás futtatása:

dotnet exec myapp.dll

dotnet myapp.dll

Lásd még