dotnet-futtatás

A cikk a következőre vonatkozik: ✔️ .NET 6 SDK és újabb verziók

Név

dotnet run – A forráskódot explicit fordítási vagy indítási parancsok nélkül futtatja.

Szinopszis

dotnet run [<applicationArguments>]
  [-a|--arch <ARCHITECTURE>] [--artifacts-path <ARTIFACTS_DIR>]
  [-c|--configuration <CONFIGURATION>] [--disable-build-servers]
  [-e|--environment <KEY=VALUE>] [--file <FILE_PATH>]
  [-f|--framework <FRAMEWORK>] [--force] [--interactive]
  [-lp|--launch-profile <NAME>] [--no-build] [--no-cache]
  [--no-dependencies] [--no-launch-profile] [--no-restore] [--os <OS>]
  [-p|--property:<PROPERTYNAME>=<VALUE>]
  [--project <PATH>] [-r|--runtime <RUNTIME_IDENTIFIER>]
  [--sc|--self-contained] [--tl:[auto|on|off]] [-v|--verbosity <LEVEL>]
  [[--] [application arguments]]

dotnet run -h|--help

Leírás

A dotnet run parancs kényelmes lehetőséget biztosít az alkalmazás forráskódból való futtatására egyetlen paranccsal. A parancssorból történő gyors iteratív fejlesztéshez hasznos. A parancs a dotnet build kód létrehozásához megadott parancstól függ. A buildre vonatkozó követelmények is érvényesek dotnet run .

A kimeneti fájlok az alapértelmezett helyre vannak beírva, ami a következő bin/<configuration>/<target>: . Ha például rendelkezik egy netcoreapp2.1 alkalmazással, és futtatja dotnet run, a kimenet a bin/Debug/netcoreapp2.1következőbe kerül: . A fájlok szükség szerint felülíródnak. Az ideiglenes fájlok a obj könyvtárba kerülnek.

Ha a projekt több keretrendszert határoz meg, a végrehajtás dotnet run hibaüzenetet eredményez, kivéve, ha a -f|--framework <FRAMEWORK> keretrendszer megadására szolgáló beállítást használja.

A dotnet run parancs a projektek környezetében használatos, nem pedig a beépített szerelvényekben. Ha ehelyett egy keretrendszerfüggő alkalmazás DLL-t próbál futtatni, parancs nélkül kell használnia a dotnetet . Futtatáshoz myapp.dllpéldául használja a következőt:

dotnet myapp.dll

Az dotnet illesztőről további információt a .NET parancssori felület áttekintésében talál.

Az alkalmazás futtatásához a dotnet run parancs feloldja az alkalmazás azon függőségeit, amelyek a NuGet-gyorsítótárból származó megosztott futtatókörnyezeten kívül vannak. Mivel gyorsítótárazott függőségeket használ, nem ajánlott dotnet run alkalmazásokat éles környezetben futtatni. Ehelyett hozzon létre egy üzembe helyezéstés telepítse a közzétett kimenetet.

Implicit visszaállítás

Nem kell futtatnia dotnet restore , mert implicit módon fut minden olyan parancs, amely visszaállítást igényel, például dotnet new, dotnet build, dotnet run, dotnet test, dotnet publishés dotnet pack. Az implicit visszaállítás letiltásához használja a --no-restore lehetőséget.

A dotnet restore parancs még mindig hasznos bizonyos esetekben, amikor a explicit visszaállításnak van értelme, például folyamatos integrációs buildek Azure DevOps Szolgáltatásokban vagy olyan buildrendszerekben, amelyeknek explicit módon kell szabályozni a visszaállítást.

A NuGet-hírcsatornák kezelésével kapcsolatos információkért tekintse meg a dokumentációtdotnet restore.

Ez a parancs támogatja a dotnet restore hosszú formában átadott beállításokat (például --source). A rövid űrlapbeállítások, például -sa rövid űrlapok nem támogatottak.

Számítási feladatjegyzék letöltése

A parancs futtatásakor a rendszer elindítja a számítási feladatok hirdetési jegyzékeinek aszinkron háttérletöltését. Ha a letöltés a parancs befejeződésekor is fut, a letöltés leáll. További információ: Hirdetési jegyzékek.

Profilok indítása

Az indítási profilok konfigurálják, hogyan dotnet run indít el egy alkalmazást a fejlesztés során. SDK-stílusú projekt esetén tegye a beállításokat a következőbe Properties/launchSettings.json: . ehelyett Visual Basic projekteket használnakMy Project/launchSettings.json.

A fájlalapú alkalmazások használhatnak egy [ApplicationName].run.json fájlt a forrásfájl mellett. A fájlkeresési sorrendről és példákról a Fájlalapú alkalmazások profilok indítása című témakörben olvashat.

Az indítási beállítások fájlja egy legfelső szintű profiles objektumot tartalmaz. Az egyes tulajdonságok profiles egy elnevezett profilt határoznak meg:

{
  "profiles": {
    "Local": {
      "commandName": "Project",
      "commandLineArgs": "--input sample.txt",
      "dotnetRunMessages": true,
      "environmentVariables": {
        "APP_MODE": "local"
      }
    }
  }
}

A .NET SDK indítási beállítások elemzője JSON-megjegyzéseket és záró vesszőket fogad.

Profil kiválasztása

Névvel ellátott profil kiválasztására használható --launch-profile <NAME> . A névegyeztetés kis- és nagybetűket nem érzékelyítő. A csak esetenként eltérő profilnevek nem egyértelműek, és hibát okoznak.

Ha nem ad meg nevet, dotnet run kiválasztja az első profilt fájlsorrendben, amelynek commandName a nevét támogatja. Az indítási beállítások fájljának kihagyására használható --no-launch-profile .

Amikor dotnet run egy profilt alkalmaz, a rendszer a kiválasztott profilnévre állítja DOTNET_LAUNCH_PROFILE be az elindított folyamat során. Egy későbbi környezeti változó forrás felülírhatja az értéket.

Támogatott profiltípusok

A .NET SDK támogatja ezeket az commandName értékeket a következőhözdotnet run: . Az értékek megkülönböztetik a kis- és nagybetűket.

commandName	Viselkedés
Project	Létrehozza a projektet, és elindítja a projekt által létrehozott parancsot.
Executable	Elindítja a megadott executablePathparancsot. Ha nem adja meg --no-build, dotnet run akkor is a projektet hozza létre először.

Általános tulajdonságok

dotnet run mindkét támogatott profiltípus esetében felismeri ezeket a tulajdonságokat:

dotnet run kibővíti a %NAME% környezetváltozó-hivatkozásokat a támogatott sztringértékekben. A .NET 11- és újabb verziókban az MSBuild tulajdonsághivatkozásokat is kiterjeszti a folyamat elindításához használt értékekben, ugyanazzal a jogkivonat-csere használatával, mint Visual Studio. Nem bontja ki a rendszerhéj stílusú $NAME hivatkozásokat.

Property	Viselkedés
commandLineArgs	Az elindított folyamat argumentumait adja meg. A parancssor explicit alkalmazásargumentumai elsőbbséget élveznek. Egy Project profil esetében a project által megadott argumentumok is elsőbbséget élveznek.
environmentVariables	Az elindított folyamat környezeti változóit adja meg. A profilértékek felülbírálják az örökölt és az SDK által létrehozott környezeti változókat, az -e\|--environment értékek pedig felülbírálják a profilértékeket.
dotnetRunMessages	Amikor truea projekt létrehozása előtt dotnet run nyomtatBuilding.... Az alapértelmezett érték false. Ez a tulajdonság nem szabályozza az indítási beállításfájlt azonosító üzenetet.

Olyan fejlesztési idejű futtatókörnyezeti konfigurációs beállítások alkalmazásához használható environmentVariables , amelyek környezeti változó űrlapot használnak. Egy profil például beállíthatja a csoportházirend-beállításokat, például DOTNET_gcServer. Az elérhető beállításokról, a környezeti változók nevéről és az elsőbbségi szabályokról lásd .NET futásidejű konfigurációs beállításokat és a futásidejű konfigurációs beállításokat a szemétgyűjtéshez.

Nem minden futtatókörnyezeti beállítás rendelkezik környezeti változó űrlappal. Ha egy alkalmazást az indítási profiltól függetlenül szeretne konfigurálni, használjon MSBuild tulajdonságot vagy RuntimeHostConfigurationOption elemet a projektben, vagy használjon egy runtimeconfig.template.json fájlt. Egyes beállítások a kódban is módosíthatók a következővel AppContext.SetSwitch: . Ezek a mechanizmusok létrehoznak vagy módosítanak az alkalmazás futtatókörnyezeti konfigurációját; ezek nem további launchSettings.json tulajdonságok.

Project tulajdonságok

dotnet runfelismeri ezeket a további tulajdonságokat, hacommandName:Project

Property	Viselkedés
applicationUrl	Beállítja ASPNETCORE_URLS az elindított folyamatot. Az ASPNETCORE_URLS értékek elsőbbséget élveznek a be- environmentVariables vagy leértékelt értékek között -e\|--environment .
launchBrowser	Azt jelzi, hogy az indítási eszköz megnyitja-e a böngészőt. dotnet run Megtartja ezt a tulajdonságot az elemzési profilban, de nem nyit meg böngészőt.
launchUrl	Azt jelzi, hogy az indítási eszköz melyik URL-címet nyissa meg. dotnet run Megtartja ezt a tulajdonságot az elemzési profilban, de nem nyit meg böngészőt, és nem használja az URL-címet.

A applicationUrl viselkedés támogatja a ASP.NET Core, de az indítási profilok és a többi közös tulajdonság minden futtatható SDK-stílusú .NET projektre vonatkozik.

Executable tulajdonságok

dotnet runfelismeri ezeket a további tulajdonságokat, hacommandName:Executable

Property	Viselkedés
executablePath	Required. Megadja az elindítandó folyamatot. Az SDK kibővíti a támogatott változóhivatkozásokat, de nem old fel relatív értéket a indítási beállítások fájljában. Használjon abszolút elérési utat vagy parancsot, amelyet az operációs rendszer megtalálhat.
workingDirectory	Optional. Megadja az elindított folyamat munkakönyvtárát. Az SDK kibővíti a támogatott változóhivatkozásokat, és feloldja a relatív elérési utat az indítási beállításokat tartalmazó könyvtárhoz képest. Ha kihagyja a tulajdonságot, a munkakönyvtár alapértelmezés szerint a projekt- vagy fájlalapú alkalmazást tartalmazó könyvtárba tartozik.

Visual Studio és hibakereső bővítmények

launchSettings.json egy megosztott bemeneti formátum, de minden fogyasztó dönti el, hogy mely értékeket támogatja, és hogyan értelmezze őket. Visual Studio, hibakeresők és más eszközök több commandName értéket és tulajdonságot ismerhetnek fel, mint dotnet runa .

Az alábbi táblázat összehasonlítja a szerződést a dotnet run Visual Studio közös .NET projektrendszer-viselkedésével:

Beállítás vagy viselkedés	dotnet run	Visual Studio
Támogatott profiltípusok	Támogatja Project és Executable.	Támogatja Projecta , Executableés egy üres commandName. A telepített projektrendszer-bővítmények más profiltípusokat is hozzáadhatnak.
Változó kiterjesztése	Kibővíti a %NAME% környezeti változók hivatkozásait. A .NET 11-.NET és újabb verziókban az MSBuild tulajdonsághivatkozásokat is kiterjeszti azokban az értékekben, amelyeket a folyamat elindításához használ.	Kiterjeszti a környezeti változókat és az MSBuild tulajdonságokat a executablePath, commandLineArgs, workingDirectory, környezeti launchUrlváltozó értékekben és sztringértékű bővítménybeállításokban.
commandLineArgs a Project	A profilértéket csak akkor használja, ha a projekt nem biztosít futtatási argumentumokat, és nem ad át alkalmazásargumentumokat a parancssorban.	Hozzáfűzi a profil értékét a projekt futtatási argumentumaihoz.
workingDirectory a Project	Figyelmen kívül hagyja a tulajdonságot.	Támogatja a tulajdonságot. A relatív elérési út a projektkönyvtárhoz képest van.
workingDirectory a Executable	A relatív elérési út az indítási beállításokat tartalmazó könyvtárhoz képest van. Ha nincs megadva, az elérési út alapértelmezés szerint a projekt vagy a fájlalapú alkalmazás könyvtára lesz.	A relatív elérési út a projektkönyvtárhoz képest van. Ha nincs megadva, az elérési út alapértelmezés szerint a kimeneti könyvtárhoz tartozik, ha az adott könyvtár létezik, vagy ha a projektkönyvtár másként van.
Relatív executablePath	Átadja az értéket az operációs rendszernek anélkül, hogy újra beleküldi.	Felold egy értéket a profil munkakönyvtárából származó elérésiút-összetevőkkel. Egy futtatható név esetében Visual Studio ellenőrzi a saját aktuális könyvtárát, majd PATH.
launchBrowser és launchUrl	Megtartja az elemzési profil értékeit, de nem nyit meg böngészőt.	Elérhetővé teszi az értékeket egy indítási szolgáltató számára. Például ASP.NET Core eszközök megnyithatnak egy böngészőt.
applicationUrl	Beállítja a elemet ASPNETCORE_URLS.	Elérhetővé teszi az értéket a telepített indítási szolgáltatók számára, például ASP.NET Core eszközök számára.
dotnetRunMessages	Szabályozza az Building... üzenetet.	Nem használja a tulajdonságot Visual Studio kimenet vezérlésére.
Hibakereső tulajdonságai	Figyelmen kívül hagyja a hibakereső-specifikus tulajdonságokat.	Olyan tulajdonságokat használ, mint a nativeDebugging, sqlDebugging, jsWebView2Debugging, remoteDebugEnabled, és hotReloadEnabled amikor a projekt és a hibakereső támogatja a funkciót.

A .NET 11-ben és újabb verziókban mindkét fogyasztó bővül"$(ProjectDir)". A korábbi verziókban egyetlen érték sem workingDirectory azonosítja a projektkönyvtárat mindkét felhasználó számára. Visual Studio kibővül"$(ProjectDir)", miközben dotnet run konstans szövegként kezeli, és feloldja az indítási beállításfájlt tartalmazó könyvtár relatív elérési útját. Ezért használhatja ".."dotnet run hagyományos Properties/launchSettings.json vagy My Project/launchSettings.json fájlhoz. Visual Studio ugyanazt az értéket feloldja a projektkönyvtár szülőjének.

Windows Forms és WPF alkalmazások nem adnak hozzá másik dotnet run profiltípust. Használjon olyan profiltProject, amely olyan gyakori beállításokkal rendelkezik, mint például commandLineArgs a .environmentVariables Az Visual Studio ezek az asztali projekttípusok a megfelelő hibakereső tulajdonságokat is használhatják, például nativeDebugging vegyesen felügyelt és natív hibakereséshez vagy jsWebView2Debugging WebView2-hez. A böngésző- és URL-tulajdonságok csak akkor lépnek érvénybe, ha egy indítási szolgáltató vagy az alkalmazás használja őket.

Más projekttípusok és Visual Studio számítási feladatok olyan indítási szolgáltatókat telepíthetnek, amelyek profiltípusokat adnak hozzá, vagy további tulajdonságokat értelmeznek. Ezek a bővítmények nem támogatják dotnet runa bővítményeket: a parancssori felület kihagyja a nem támogatott profiltípusokat az alapértelmezett kiválasztás során, és hibaüzenetet jelent, ha explicit módon választ egyet.

Ha Visual Studio támogatott hibakeresői beállításait és project felhasználói felületét, tekintse meg Project .NET C#-hibakeresési konfiguráció beállításait.

Arguments

<applicationArguments>

A futtatott alkalmazásnak átadott argumentumok.

A nem felismert dotnet run argumentumokat a rendszer átadja az alkalmazásnak. Ha el szeretné különíteni az dotnet run argumentumokat az alkalmazás argumentumaitól, használja a -- lehetőséget.

Argumentumok továbbítása az alkalmazásnak

dotnet run továbbít minden olyan jogkivonatot, amelyet nem ismer fel az alkalmazásnak. A továbbított jogkivonatok megtartják az eredeti sorrendet, de dotnet run először eltávolítják az általa megismert beállításokat. Ha egy felismert beállítás egy ismeretlen beállítás neve és értéke között jelenik meg, a felismert beállítás eltávolítása megváltoztathatja a maradék jogkivonatok jelentését.

Az alábbi parancs például a felismert beállítást --project foglalja össze az alkalmazás által fogadni kívánt jogkivonatok között:

dotnet run --app-flag --app-name --project ConsoleApp.csproj A.txt

A használat dotnet runután --project ConsoleApp.csproj az alkalmazás megkapja a következőt--app-flag --app-name A.txt: . Az alkalmazás ezután az eredeti parancssornak nem megfelelő értékként A.txtkezeli--app-name.

A kétértelműség elkerülése érdekében helyezze el az alkalmazás argumentumait egy konstans --után:

dotnet run --project ConsoleApp.csproj -- --app-flag --app-name A.txt

Az -- elválasztó az alábbi jogkivonatokat alkalmazásargumentumként jelöli meg, ezért dotnet run nem rendezi újra vagy értelmezi újra őket. Az elválasztó emellett időtálló szkripteket is használ az új dotnet run beállításokhoz, amelyek később megegyezhetnek az alkalmazásnak korábban továbbított jogkivonattal.

Note

Ugyanez a viselkedés vonatkozik dotnet build és dotnet test Microsoft. Testing.Platform (MTP) mód, amely ismeretlen jogkivonatokat továbbít az MSBuildnek vagy a tesztalkalmazásnak. További információ: dotnet testArgumentumok továbbítása a tesztalkalmazáshoz.

Beállítások

• --

  Elválasztja az dotnet run argumentumokat a futtatott alkalmazás argumentumaitól. Az elválasztójel utáni összes argumentumot a rendszer átadja az alkalmazásfuttatásnak.

• -a|--arch <ARCHITECTURE>

  A célarchitektúra megadása. Ez egy rövidített szintaxis a futtatókörnyezet azonosítójának (RID) beállításához, ahol a megadott érték az alapértelmezett RID-vel van kombinálva. Egy gépen például win-x64 a RID beállítása a következőre --arch x86van advawin-x86: . Ha ezt a lehetőséget használja, ne használja a -r|--runtime beállítást. .NET 7. előzetes verzió óta érhető el.

• --artifacts-path <ARTIFACTS_DIR>

  A végrehajtott parancs összes buildkimeneti fájlja a megadott elérési út alatti almappákba kerül, projekt szerint elválasztva. További információ: Artifacts Kimeneti elrendezés. Ezt a lehetőséget és a megadott értéket explicit módon kaszkádoltnak kell lennie minden olyan dotnet parancsban, amely egy másik dotnet parancs kimenetétől függ, például a használat dotnet build --no-restore és dotnet publish --no-builda . .NET 8 SDK óta érhető el.

• -c|--configuration <CONFIGURATION>

  Meghatározza a buildkonfigurációt. A legtöbb projekt esetében az Debugalapértelmezett beállítás, de felülbírálhatja a projekt buildkonfigurációs beállításait.

• --disable-build-servers

  Kényszeríti a parancsot az állandó buildkiszolgálók figyelmen kívül hagyására. Ez a beállítás konzisztens módot biztosít a buildek gyorsítótárazásának letiltására, ami az alapoktól kényszeríti a buildeket. A gyorsítótárakra nem támaszkodó buildek akkor hasznosak, ha a gyorsítótárak valamilyen okból sérültek vagy helytelenek. .NET 7 SDK óta érhető el.

• -e|--environment <KEY=VALUE>

  Beállítja a megadott környezeti változót a parancs által futtatandó folyamatban. A megadott környezeti változó nincs alkalmazva a dotnet run folyamatra.

  Az ebben a beállításban átadott környezeti változók elsőbbséget élveznek a környezeti környezeti változókkal, a System.CommandLine-irányelvekkel env és environmentVariables a kiválasztott indítási profillal szemben. További információ: Környezeti változók.

  (Ez a beállítás .NET SDK 9.0.200-ban lett hozzáadva.)

• -f|--framework <FRAMEWORK>

  Létrehozza és futtatja az alkalmazást a megadott keretrendszer használatával. A keretrendszert meg kell adni a projektfájlban.

• --file <FILE_PATH>

  A futtatandó fájlalapú alkalmazás elérési útja. Ha nincs megadva elérési út, a rendszer az aktuális könyvtárat használja a fájl megkereséséhez és futtatásához. További információ a fájlalapú alkalmazásokról: Fájlalapú C#-alkalmazások létrehozása.

  A Unixon közvetlenül a fájlnév használatával hajthat végre fájlalapú alkalmazásokat egy shebang (#!) irányelv hozzáadásával és a végrehajtási engedély beállításával. További információ: Unix shebang (#!) támogatás.

  A .NET SDK 10.0.100-ban bevezetett.

• --force

  Minden függőséget feloldani kell, még akkor is, ha az utolsó visszaállítás sikeres volt. A jelölő megadása megegyezik a project.assets.json fájl törlésével.

• --interactive

  Lehetővé teszi, hogy a parancs leálljon, és várja meg a felhasználói bemenetet vagy műveletet. Például a hitelesítés befejezéséhez.

• -lp|--launch-profile <NAME>

  Az alkalmazás indításakor használni kívánt indítási profil neve. További információ: Profilok indítása.

• --no-build

  Futtatás előtt nem hozza létre a projektet. Implicit módon beállítja a jelölőt --no-restore is.

• --no-cache

  A futtatás előtt hagyja ki a naprakész ellenőrzéseket, és mindig hozza létre a programot.

• --no-dependencies

  Projekt projektközi (P2P) hivatkozásokkal történő visszaállításakor a gyökérprojektet állítja vissza, nem pedig a hivatkozásokat.

• --no-launch-profile

  Nem próbálja launchSettings.json használni az alkalmazás konfigurálásához.

• --no-restore

  Nem hajt végre implicit visszaállítást a parancs futtatásakor.

• --no-self-contained

  Az alkalmazás közzététele keretrendszerfüggő alkalmazásként. Az alkalmazás futtatásához telepíteni kell egy kompatibilis .NET futtatókörnyezetet a célgépre.

• --os <OS>

  A cél operációs rendszer (OS) megadása. Ez egy rövidített szintaxis a futtatókörnyezet azonosítójának (RID) beállításához, ahol a megadott érték az alapértelmezett RID-vel van kombinálva. Egy gépen például win-x64 a RID beállítása a következőre --os linuxvan advalinux-x64: . Ha ezt a lehetőséget használja, ne használja a -r|--runtime beállítást. 6 .NET óta érhető el.

• --project <PATH>

  Megadja a futtatni kívánt projektfájl elérési útját (mappanév vagy teljes elérési út). Ha nincs megadva, alapértelmezés szerint az aktuális könyvtár lesz.

  A -p--project rövidítése elavult .NET 6 SDK-tól kezdve. Korlátozott ideig -p továbbra is használható --project az elavulással kapcsolatos figyelmeztetés ellenére. Ha a beállításhoz megadott argumentum nem tartalmaz =, a parancs rövidnek fogadja el -p a következőt --project: . Ellenkező esetben a parancs feltételezi, hogy -p ez a rövid kifejezés.--property A -p--project rugalmas használata a 7. .NET-ben lesz megszüntetve.

• --property:<NAME>=<VALUE>

  Beállít egy vagy több MSBuild tulajdonságot. Adjon meg több tulajdonságot pontosvesszővel vagy a beállítás ismétlésével:

  --property:<NAME1>=<VALUE1>;<NAME2>=<VALUE2>
  --property:<NAME1>=<VALUE1> --property:<NAME2>=<VALUE2>
  

  A rövid űrlap -p használható a következőhöz --property: . Ha a beállításhoz megadott argumentum tartalmaz =, -p akkor a rendszer rövidnek fogadja el a következőt --property: . Ellenkező esetben a parancs feltételezi, hogy -p ez a rövid kifejezés.--project

  Ha az MSBuild tulajdonság beállítása helyett az alkalmazásnak szeretne átadni --property , adja meg a -- szintaxiselválasztó utáni lehetőséget, például:

  dotnet run -- --property name=value
  

• -r|--runtime <RUNTIME_IDENTIFIER>

  Megadja a cél futtatókörnyezetet a csomagok visszaállításához. A futtatókörnyezet-azonosítók (RID-k) listáját a RID-katalógusban találja.

• --sc|--self-contained

  Tegye közzé a .NET futtatókörnyezetet az alkalmazással, hogy a futtatókörnyezetet ne kelljen telepíteni a célgépre.

• --tl:[auto|on|off]

  Megadja, hogy a terminálnaplózót használni kell-e a buildkimenethez. Az alapértelmezett érték az auto, amely először ellenőrzi a környezetet a terminálnaplózás engedélyezése előtt. A környezet ellenőrzi, hogy a terminál képes-e modern kimeneti funkciókat használni, és nem használ átirányított szabványos kimenetet az új naplózó engedélyezése előtt. on kihagyja a környezetellenőrzést, és engedélyezi a terminálnaplózást. off kihagyja a környezetellenőrzést, és az alapértelmezett konzolnaplózót használja.

  A Terminálnaplózó megjeleníti a visszaállítási fázist, majd a buildelési fázist. Az egyes fázisok során az éppen épülő projektek a terminál alján jelennek meg. Az épület összes projektje az MSBuild-célt és a célra fordított időt is kimeneteli. Ebben az információban további információt talál a buildről. Amikor egy projekt befejeződött, egyetlen "befejezett build" szakasz lesz megírva, amely rögzíti a következőt:

  • Az épített projekt neve.
  • A cél-keretrendszer (ha több-célzott).
  • A build állapota.
  • A build elsődleges kimenete (amely hivatkozásra van hivatkozva).
  • A projekthez létrehozott diagnosztikák.

  Ez a beállítás .NET 8-tól érhető el.

• -v|--verbosity <LEVEL>

  A parancs részletességi szintjét állítja be. Az engedélyezett értékek a következőkq[uiet]: , m[inimal], n[ormal]d[etailed]és diag[nostic]. Az alapértelmezett érték minimal. További információ: LoggerVerbosity.

• -?|-h|--help

  A parancs használatának leírását nyomtatja ki.

Környezeti változók

Az alábbi források környezeti változókat alkalmaznak az elindított alkalmazásra:

1. Környezeti környezeti változók az operációs rendszerből a parancs futtatásakor.
2. System.CommandLine-irányelvek env , például [env:key=value]. Ezek a teljes dotnet run folyamatra vonatkoznak, nem csak a projektre, amelyet a dotnet runprogram futtat.
3. A kiválasztott indítási profilból létrehozott értékek. dotnet run halmazokban DOTNET_LAUNCH_PROFILEés applicationUrl profilkészletekben ProjectASPNETCORE_URLS.
4. environmentVariables a kiválasztott indítási profilból, ha van ilyen. Ezek a projekt által futtatott dotnet runprojektre vonatkoznak.
5. -e|--environment PARANCSSOR-beállításértékek (.NET SDK 9.0.200-es verziójában). Ezek a projekt által futtatott dotnet runprojektre vonatkoznak.

A környezet ugyanabban a sorrendben van felépítve, mint ez a lista, így a -e|--environment beállítás a legmagasabb prioritással rendelkezik.

Példák

• Futtassa a projektet az aktuális könyvtárban:

  dotnet run
  

• Futtassa a megadott fájlalapú alkalmazást az aktuális könyvtárban:

  dotnet run --file ConsoleApp.cs
  

  A fájlalapú alkalmazástámogatás .NET SDK 10.0.100-ban lett hozzáadva.

• Futtassa a megadott projektet:

  dotnet run --project ./projects/proj1/proj1.csproj
  

• Futtassa a projektet az aktuális könyvtárban, és adja meg a kiadási konfigurációt:

  dotnet run --property:Configuration=Release
  

• Futtassa a projektet az aktuális könyvtárban (a --help példában szereplő argumentumot a rendszer átadja az alkalmazásnak, mivel az üres -- beállítást használja):

  dotnet run --configuration Release -- --help
  

• Állítsa vissza a projekt függőségeit és eszközeit az aktuális könyvtárban, csak minimális kimenettel, majd futtassa a projektet:

  dotnet run --verbosity m
  

• Futtassa a projektet az aktuális könyvtárban a megadott keretrendszer használatával, és adja át az argumentumokat az alkalmazásnak:

  dotnet run -f net6.0 -- arg1 arg2
  

  Az alábbi példában a rendszer három argumentumot ad át az alkalmazásnak. Az egyik argumentumot a rendszer a következővel -adja át, majd két argumentumot ad át --:

  dotnet run -f net6.0 -arg1 -- arg2 arg3