.NET környezeti változók

Cikk
11/08/2023

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

Ebben a cikkben megismerheti a .NET által használt környezeti változókat. Egyes környezeti változókat a .NET-futtatókörnyezet használ, míg másokat csak a .NET SDK és a .NET CLI használ. Egyes környezeti változókat mindhárom összetevő használ.

.NET futtatókörnyezet környezeti változói

`DOTNET_SYSTEM_NET_HTTP_*`

Számos globális HTTP környezeti változóbeállítás létezik:

DOTNET_SYSTEM_NET_HTTP_ENABLEACTIVITYPROPAGATION
- Azt jelzi, hogy engedélyezi-e a diagnosztikai kezelő tevékenységpropagálását a globális HTTP-beállításokhoz.
DOTNET_SYSTEM_NET_HTTP_SOCKETSHTTPHANDLER_HTTP2SUPPORT
- Ha be van állítva, false vagy 0letiltja a HTTP/2 támogatását, amely alapértelmezés szerint engedélyezve van.
DOTNET_SYSTEM_NET_HTTP_SOCKETSHTTPHANDLER_HTTP3SUPPORT
- Ha be van állítva vagy 1, engedélyezi a true HTTP/3 támogatását, amely alapértelmezés szerint le van tiltva.
DOTNET_SYSTEM_NET_HTTP_SOCKETSHTTPHANDLER_HTTP2FLOWCONTROL_DISABLEDYNAMICWINDOWSIZING
- Ha be van false állítva vagy 0, felülbírálja az alapértelmezett értéket, és letiltja a HTTP/2 dinamikus ablakméretezési algoritmust.
DOTNET_SYSTEM_NET_HTTP_SOCKETSHTTPHANDLER_FLOWCONTROL_MAXSTREAMWINDOWSIZE
- Alapértelmezés szerint 16 MB. Felülírás esetén a HTTP/2 stream fogadási ablakának maximális mérete nem lehet kisebb 65 535-nél.
DOTNET_SYSTEM_NET_HTTP_SOCKETSHTTPHANDLER_FLOWCONTROL_STREAMWINDOWSCALETHRESHOLDMULTIPLIER
- Alapértelmezett érték: 1.0. Felül bírálat esetén a magasabb értékek rövidebb időt, de lassabb letöltést eredményeznek. Nem lehet 0-nál kisebb.

`DOTNET_SYSTEM_GLOBALIZATION_*`

DOTNET_SYSTEM_GLOBALIZATION_INVARIANT: Lásd az invariáns mód beállítását.
DOTNET_SYSTEM_GLOBALIZATION_PREDEFINED_CULTURES_ONLY: Azt határozza meg, hogy csak előre definiált kultúrákat tölt-e be.
DOTNET_SYSTEM_GLOBALIZATION_APPLOCALICU: Azt jelzi, hogy a Unicode (ICU) alkalmazás helyi nemzetközi összetevőit használja-e. További információ: App-local ICU.

Invariáns mód beállítása

Az alkalmazások az alábbi módokon engedélyezhetik az invariáns módot:

A projektfájlban:

<PropertyGroup>
    <InvariantGlobalization>true</InvariantGlobalization>
</PropertyGroup>

A runtimeconfig.json fájlban:

{
    "runtimeOptions": {
        "configProperties": {
            "System.Globalization.Invariant": true
        }
    }
}

A környezeti változó értékének DOTNET_SYSTEM_GLOBALIZATION_INVARIANT beállításával a következőre true : vagy 1.

Fontos

A projektfájlban vagy a runtimeconfig.json fájlban beállított érték nagyobb prioritással rendelkezik, mint a környezeti változó.

További információ: .NET Globalization Invariant Mode.

`DOTNET_SYSTEM_GLOBALIZATION_USENLS`

Ez csak a Windowsra vonatkozik. A globalizáláshoz használja a nemzeti nyelvi támogatást (NLS), állítsa DOTNET_SYSTEM_GLOBALIZATION_USENLS be vagy 1true . Ha nem szeretné használni, állítsa be DOTNET_SYSTEM_GLOBALIZATION_USENLS a következőt: vagy false0.

`DOTNET_SYSTEM_NET_SOCKETS_*`

Ez a szakasz két System.Net.Sockets környezeti változóra összpontosít:

DOTNET_SYSTEM_NET_SOCKETS_INLINE_COMPLETIONS
DOTNET_SYSTEM_NET_SOCKETS_THREAD_COUNT

A szoftvercsatornák folytatásai az System.Threading.ThreadPool eseményszálból lesznek elküldve. Így elkerülhető, hogy a folytatások blokkolják az eseménykezelést. Ha engedélyezni szeretné, hogy a folytatások közvetlenül az eseményszálon fussanak, állítsa a következőre DOTNET_SYSTEM_NET_SOCKETS_INLINE_COMPLETIONS1: . Alapértelmezés szerint le van tiltva.

Megjegyzés:

Ez a beállítás ronthatja a teljesítményt, ha költséges munka történik, amely a szükségesnél hosszabb ideig tartja az IO-szálat. Tesztelje, hogy ez a beállítás segít-e a teljesítményben.

A TechEmpower-teljesítménytesztek használatával, amelyek sok kis szoftvercsatornás olvasást és írást hoznak létre nagyon nagy terhelés mellett, egyetlen szoftvercsatornás motor képes akár harminc x64 és nyolc Arm64 processzormag foglaltságára is. A valós forgatókönyvek túlnyomó többsége soha nem hoz létre ilyen nagy terhelést (másodpercenként több százezer kérést), és egyetlen gyártó szinte mindig elegendő. A számított érték felülbírálásához DOTNET_SYSTEM_NET_SOCKETS_THREAD_COUNT azonban a szélsőséges terhelések kezelhetők. Ha nincs felülírva, a rendszer a következő értéket használja:

Ha DOTNET_SYSTEM_NET_SOCKETS_INLINE_COMPLETIONS igen 1, akkor a rendszer az Environment.ProcessorCount értéket használja.
Ha DOTNET_SYSTEM_NET_SOCKETS_INLINE_COMPLETIONS nem 1, RuntimeInformation.ProcessArchitecture akkor a kiértékelés a következő:
- Arm vagy Arm64 esetén a motoronkénti magok beállítása 8máskülönben 30.
A motoronként meghatározott magok használatával a motoronkénti 1Environment.ProcessorCount magok vagy a magok feletti maximális érték.

`DOTNET_SYSTEM_NET_DISABLEIPV6`

Segít megállapítani, hogy az Internet Protocol 6-os verziója (IPv6) le van-e tiltva. Ha az IPv6 értéke vagy valamelyike true1, akkor az IPv6 le van tiltva, kivéve, ha a beállítás másként van megadva a System.AppContextfájlban.

`DOTNET_SYSTEM_NET_HTTP_USESOCKETSHTTPHANDLER`

Az alábbi mechanizmusok egyikével konfigurálhat egy folyamatot a régebbiek HttpClientHandlerhasználatára:

A kódból használja az osztályt AppContext :

AppContext.SetSwitch("System.Net.Http.UseSocketsHttpHandler", false);

A AppContext kapcsolót konfigurációs fájllal is beállíthatja. A kapcsolók konfigurálásával kapcsolatos további információkért lásd: AppContext for library consumers.

Ugyanezt a környezeti változóval DOTNET_SYSTEM_NET_HTTP_USESOCKETSHTTPHANDLERis el lehet érni. A letiltáshoz állítsa az értéket a következőre: vagy false0.

Megjegyzés:

A .NET 5-től kezdve ez a használni HttpClientHandler kívánt beállítás már nem érhető el.

`DOTNET_Jit` és `DOTNET_GC`

A JIT és a JIT által generált GC-információknak két stresszel kapcsolatos funkciója van: a JIT Stress és a GC Hole Stress. Ezek a funkciók lehetővé teszik a fejlesztés során, hogy felfedezzék a peremhálózati eseteket és a "valós" forgatókönyveket anélkül, hogy összetett alkalmazásokat kellene fejleszteniük. A következő környezeti változók érhetők el:

DOTNET_JitStress
DOTNET_JitStressModeNamesOnly
DOTNET_GCStress

JIT-stressz

A JIT-stressz engedélyezése többféleképpen is elvégezhető. Állítsa nem DOTNET_JitStress nulla egész számra a JIT-optimalizálás különböző szintjeinek létrehozásához a metódus nevének kivonata alapján. Például az összes optimalizálási csoport DOTNET_JitStress=2alkalmazásához. A JIT Stress engedélyezésének másik módja, ha DOTNET_JitStressModeNamesOnly=1 beállítja, majd kéri a változóban DOTNET_JitStressModeNames a térelhatárolt stressz módokat.

Vegyük például a következőt:

DOTNET_JitStressModeNames=STRESS_USE_CMOV STRESS_64RSLT_MUL STRESS_LCL_FLDS

GC-furat terhelése

A GC-lyukterhelés engedélyezésével a csoportházirend-objektumok mindig meghatározott helyeken fordulnak elő, és ez segít a GC-lyukak nyomon követésében. A GC-lyukterhelés a DOTNET_GCStress környezeti változóval engedélyezhető.

További információ: JIT- és GC-lyukterhelés vizsgálata.

JIT memóriakorlátok

Az Arm64 kódgenerátora lehetővé teszi az összes MemoryBarriers utasítás eltávolítását 1a következő beállítássalDOTNET_JitNoMemoryBarriers: .

`DOTNET_RUNNING_IN_CONTAINER` és `DOTNET_RUNNING_IN_CONTAINERS`

A hivatalos .NET-rendszerképek (Windows és Linux) a jól ismert környezeti változókat állítják be:

DOTNET_RUNNING_IN_CONTAINER
DOTNET_RUNNING_IN_CONTAINERS

Ezek az értékek határozzák meg, hogy a ASP.NET core számítási feladatok mikor futnak egy tároló kontextusában.

`DOTNET_SYSTEM_CONSOLE_ALLOW_ANSI_COLOR_REDIRECTION`

Ha Console.IsOutputRedirected igen true, akkor ANSI-színkódot bocsáthat ki a következő beállítással DOTNET_SYSTEM_CONSOLE_ALLOW_ANSI_COLOR_REDIRECTION : vagy 1true.

`DOTNET_SYSTEM_DIAGNOSTICS` és kapcsolódó változók

DOTNET_SYSTEM_DIAGNOSTICS_DEFAULTACTIVITYIDFORMATISHIERARCHIAL: Amikor 1 vagy true, az alapértelmezett tevékenységazonosító-formátum hierarchikus.
DOTNET_SYSTEM_RUNTIME_CACHING_TRACING: Hibakeresésként való futtatáskor a nyomkövetés engedélyezhető, ha ez történik true.

`DOTNET_DiagnosticPorts`

Alternatív végpontokat konfigurál, ahol a diagnosztikai eszközök kommunikálhatnak a .NET-futtatókörnyezettel. További információért tekintse meg a diagnosztikai port dokumentációját .

`DOTNET_DefaultDiagnosticPortSuspend`

A futtatókörnyezetet úgy konfigurálja, hogy az indítás során szüneteljen, és várja meg a Diagnosztikai IPC ResumeStartup parancsot a megadott diagnosztikai portról, ha az 1 értékre van állítva. Alapértelmezés szerint 0. További információért tekintse meg a diagnosztikai port dokumentációját .

`DOTNET_EnableDiagnostics`

Ha be van 0állítva, letiltja a hibakeresést, a profilkészítést és az egyéb diagnosztikát a diagnosztikai porton keresztül, és más diagnosztikai beállítások nem bírálhatók felül. Alapértelmezett érték: 1.

`DOTNET_EnableDiagnostics_IPC`

A .NET 8-tól kezdve, ha be van 0állítva, letiltja a diagnosztikai portot , és más diagnosztikai beállítások nem bírálhatók felül. Alapértelmezett érték: 1.

`DOTNET_EnableDiagnostics_Debugger`

A .NET 8-tól kezdve, ha be van 0állítva, letiltja a hibakeresést, és más diagnosztikai beállítások nem bírálhatók felül. Alapértelmezett érték: 1.

`DOTNET_EnableDiagnostics_Profiler`

A .NET 8-tól kezdve, ha be van 0állítva, letiltja a profilkészítést, és más diagnosztikai beállítások nem bírálhatók felül. Alapértelmezett érték: 1.

EventPipe-változók

További információkért tekintse meg az EventPipe környezeti változóit .

DOTNET_EnableEventPipe: Ha be van állítva, engedélyezi a 1nyomkövetést az EventPipe-en keresztül.
DOTNET_EventPipeOutputPath: Az a kimeneti elérési út, ahol a nyomkövetés meg lesz írva.
DOTNET_EventPipeOutputStreaming: Ha be van 1állítva, engedélyezi a kimeneti fájlba való streamelést az alkalmazás futtatása közben. Alapértelmezés szerint a nyomkövetési információk körkörös pufferben halmozódnak fel, és a tartalom az alkalmazás leállításakor lesz megírva.

.NET SDK és CLI környezeti változók

`DOTNET_ROOT`, `DOTNET_ROOT(x86)`

Megadja a .NET-futtatókörnyezetek helyét, ha nincsenek telepítve az alapértelmezett helyen. A Windows alapértelmezett helye a következő C:\Program Files\dotnet: . A macOS alapértelmezett helye a következő /usr/local/share/dotnet: . A Linuxon az alapértelmezett hely a disztribúciótól és a telepítési módszertől függően változik. Az Ubuntu 22.04 alapértelmezett helye (ha az Ubuntu 22.04-ről /usr/share/dotnetpackages.microsoft.comvan telepítve) vagy /usr/lib/dotnet (ha a Jammy-csatornáról van telepítve). További információkat találhat az alábbi forrásokban:

Ez a környezeti változó csak akkor használatos, ha az alkalmazásokat generált végrehajtható fájlokon (apphostokon) keresztül futtatja. DOTNET_ROOT(x86) 64 bites operációs rendszeren futtatható 32 bites futtatáskor használatos.

`DOTNET_HOST_PATH`

Megadja a jelenleg futó dotnet folyamat elindításához dotnet használt gazdagép abszolút elérési útját (dotnet.exeWindowson, dotnet Linuxon és macOS rendszeren). Ezt a .NET SDK használja a .NET SDK-parancsok során futó eszközök segítségére, hogy ugyanazt dotnet a futtatókörnyezetet használják a parancs időtartamára létrehozott gyermekfolyamatokhoz dotnet . Az SDK azon eszközei és MSBuild feladatai, amelyek bináris fájlokat hívnak meg a gazdagépen keresztül, várhatóan tiszteletben tartják ezt a dotnet környezeti változót a konzisztens élmény biztosítása érdekében.

Az SDK-parancsok során meghívott dotnet eszközöknek a következő algoritmust kell használniuk a megkereséséhez:

ha DOTNET_HOST_PATH be van állítva, használja ezt az értéket közvetlenül
egyéb esetben a dotnet rendszer PATH

Megjegyzés:

DOTNET_HOST_PATH nem általános megoldás a gazdagép helyének dotnet tárolására. Csak a .NET SDK által meghívott eszközök használhatják.

`DOTNET_LAUNCH_PROFILE`

A dotnet run parancs ezt a változót a kiválasztott indítási profilra állítja.

A következő indítási Gépház.json-fájlra tekintettel:

{
  "profiles": {
    "First": {
      "commandName": "Project",
    },
    "Second": {
      "commandName": "Project",
    }
  }
}

És a következő Program.cs fájl:

var value = Environment.GetEnvironmentVariable("DOTNET_LAUNCH_PROFILE");
Console.WriteLine($"DOTNET_LAUNCH_PROFILE={value}");

A következő forgatókönyvek a következő kimenetet eredményezik:

A megadott és létező indítási profil

$ dotnet run --launch-profile First
DOTNET_LAUNCH_PROFILE=First

Az indítási profil nincs megadva, az első ki van jelölve
```
$ dotnet run
DOTNET_LAUNCH_PROFILE=First
```

A megadott, de nem létező indítási profil

$ dotnet run --launch-profile Third
The launch profile "Third" could not be applied.
A launch profile with the name 'Third' doesn't exist.
DOTNET_LAUNCH_PROFILE=

Indítás profil nélkül

$ dotnet run --no-launch-profile
DOTNET_LAUNCH_PROFILE=

`NUGET_PACKAGES`

A globális csomagok mappája. Ha nincs beállítva, az alapértelmezés szerint ~/.nuget/packages Unix vagy %userprofile%\.nuget\packages Windows rendszeren van.

`DOTNET_SERVICING`

Megadja annak a karbantartási indexnek a helyét, amelyet a megosztott gazdagép használ a futtatókörnyezet betöltésekor.

`DOTNET_NOLOGO`

Megadja, hogy az első futtatáskor megjelenjenek-e a .NET üdvözlő- és telemetriaüzenetei. Állítsa be, hogy true elnémítsa ezeket az üzeneteket (értékek true, 1vagy elfogadott), vagy yes állítsa be, hogy false engedélyezze őket (értékek false, 0vagy no elfogadott). Ha nincs beállítva, az alapértelmezett érték, false és az üzenetek megjelennek az első futtatáskor. Ez a jelző nem befolyásolja a telemetriát (lásd DOTNET_CLI_TELEMETRY_OPTOUT a telemetriai adatok küldésének letiltását).

`DOTNET_CLI_PERF_LOG`

Megadja, hogy a rendszer naplózza-e az aktuális CLI-munkamenet teljesítményadatait. Engedélyezve van, ha be van állítva a következőre: 1, truevagy yes. A beállítás alapértelmezés szerint le van tiltva.

`DOTNET_GENERATE_ASPNET_CERTIFICATE`

Megadja, hogy létre kell-e hozni egy ASP.NET Core-tanúsítványt. Az alapértelmezett érték az true, de ezt felül lehet bírálni, ha ezt a környezeti változót a 0következőre állítja: , falsevagy no.

`DOTNET_ADD_GLOBAL_TOOLS_TO_PATH`

Megadja, hogy globális eszközöket kell-e hozzáadni a PATH környezeti változóhoz. Az alapértelmezett érték true. Ha nem szeretne globális eszközöket hozzáadni az elérési úthoz, állítsa be 0az , falsevagy no.

`DOTNET_CLI_TELEMETRY_OPTOUT`

Megadja, hogy a .NET-eszközök használatára vonatkozó adatok összegyűjtve és elküldve legyenek-e a Microsoftnak. Állítsa be a true telemetriai funkció letiltására (értékek true, 1vagy yes elfogadott). Ellenkező esetben állítsa be false a telemetriai funkciók (értékek false, 0vagy no elfogadottak) engedélyezését. Ha nincs beállítva, az alapértelmezett érték, false és a telemetriai funkció aktív.

`DOTNET_SKIP_FIRST_TIME_EXPERIENCE`

Ha DOTNET_SKIP_FIRST_TIME_EXPERIENCE be van állítva true, a NuGetFallbackFolder lemez nem lesz kibontva, és megjelenik egy rövidebb üdvözlőüzenet és telemetriai értesítés.

Megjegyzés:

Ez a környezeti változó már nem támogatott a .NET Core 3.0-s és újabb verzióiban. Csereként használható DOTNET_NOLOGO .

`DOTNET_MULTILEVEL_LOOKUP`

Megadja, hogy a .NET-futtatókörnyezet, a megosztott keretrendszer vagy az SDK feloldva legyen-e a globális helyről. Ha nincs beállítva, alapértelmezés szerint 1 (logikai true). Állítsa az értéket 0 (logikai false) értékre, hogy ne oldódjon fel a globális helyről, és izolált .NET-telepítésekkel rendelkezzen. A többszintű keresésről további információt a Többszintű SharedFX-keresés című témakörben talál.

Megjegyzés:

Ez a környezeti változó csak a .NET 6-os és korábbi verzióit célzó alkalmazásokra vonatkozik. A .NET 7-től kezdve a .NET csak egy helyen keres keretrendszereket. További információ: A többszintű keresés le van tiltva.

`DOTNET_ROLL_FORWARD`

Meghatározza az előregördítés viselkedését. További információkért tekintse meg a --roll-forward parancs beállításátdotnet.

`DOTNET_ROLL_FORWARD_TO_PRERELEASE`

Ha be van állítva 1 (engedélyezve), lehetővé teszi a kiadás előtti verzióra való továbbgördülést egy kiadási verzióról. Alapértelmezés szerint (0 - letiltva) a .NET-futtatókörnyezet kiadási verziójának kérése esetén a visszaállítás csak a telepített kiadási verziókat veszi figyelembe.

További információkért lásd a --roll-forward parancs beállítását dotnet

`DOTNET_ROLL_FORWARD_ON_NO_CANDIDATE_FX`

Letiltja az alverzió előregördítését, ha be van 0állítva. Ez a beállítás a .NET Core 3.0-ban felülírva DOTNET_ROLL_FORWARD. Ehelyett az új beállításokat kell használni.

`DOTNET_CLI_FORCE_UTF8_ENCODING`

Kényszeríti az UTF-8 kódolás használatát a konzolon, még a Windows 10 régebbi verziói esetében is, amelyek nem támogatják teljes mértékben az UTF-8-at. További információ: Az SDK már nem módosítja a konzol kódolását, ha elkészült.

`DOTNET_CLI_UI_LANGUAGE`

Beállítja a parancssori felület nyelvét egy olyan területi érték használatával, mint a en-us. A támogatott értékek megegyeznek a Visual Studióval. További információkért tekintse meg a telepítő nyelvének módosításáról szóló szakaszt a Visual Studio telepítési dokumentációjában. A .NET-erőforrás-kezelő szabályai érvényesek, így nem kell pontos egyezést választania – a fa leszármazottait CultureInfo is kiválaszthatja. Ha például ezt állítja be fr-CA, a parancssori felület megkeresi és használja a fr fordításokat. Ha olyan nyelvre állítja be, amely nem támogatott, a parancssori felület vissza fog esni az angol nyelvre.

`DOTNET_DISABLE_GUI_ERRORS`

GUI-kompatibilis generált végrehajtható fájlok esetén – letiltja a párbeszédpanel előugró ablakát, amely általában bizonyos hibaosztályok esetén jelenik meg. Csak ezekben az esetekben ír és stderr lép ki.

`DOTNET_ADDITIONAL_DEPS`

Egyenértékű a parancssori felület beállítással --additional-deps.

`DOTNET_RUNTIME_ID`

Felülbírálja az észlelt RID-et.

`DOTNET_SHARED_STORE`

Annak a "megosztott tárolónak" a helye, amelyre a szerelvényfeloldás bizonyos esetekben visszaesik.

`DOTNET_STARTUP_HOOKS`

Az indítási horgok betöltéséhez és végrehajtásához tartozó szerelvények listája.

`DOTNET_BUNDLE_EXTRACT_BASE_DIR`

Megadja azt a könyvtárat, amelybe egy egyfájlos alkalmazás lesz kinyerve a végrehajtás előtt.

További információ: Egyfájlos végrehajtható fájlok.

`DOTNET_CLI_CONTEXT_*`

DOTNET_CLI_CONTEXT_VERBOSE: Részletes környezet engedélyezéséhez állítsa be a következőt true: .
DOTNET_CLI_CONTEXT_ANSI_PASS_THRU: Az ANSI-átvitel engedélyezéséhez állítsa a következőre true: .

`DOTNET_CLI_WORKLOAD_UPDATE_NOTIFY_DISABLE`

Letiltja a hirdetési jegyzékek háttérletöltését a számítási feladatokhoz. Az alapértelmezett érték – false nincs letiltva. Ha be van trueállítva, a letöltés le van tiltva. További információ: Hirdetési jegyzékek.

`DOTNET_CLI_WORKLOAD_UPDATE_NOTIFY_INTERVAL_HOURS`

Megadja a számítási feladatokhoz tartozó hirdetési jegyzékek háttérletöltései közötti minimális óraszámot. Az alapértelmezett érték az 24, amely nem gyakrabban, mint naponta egyszer. További információ: Hirdetési jegyzékek.

`DOTNET_TOOLS_ALLOW_MANIFEST_IN_ROOT`

Megadja, hogy a .NET SDK helyi eszközei keresnek-e eszközjegyzékfájlokat a Windows gyökérmappájában. Az alapértelmezett érték false.

`COREHOST_TRACE`

Szabályozza a diagnosztikai nyomkövetést az üzemeltetési összetevőkről, például dotnet.exe, hostfxrés hostpolicy.

COREHOST_TRACE=[0/1] - alapértelmezés szerint a 0 nyomkövetés le van tiltva. Ha be van állítva, 1a diagnosztikai nyomkövetés engedélyezve van.
COREHOST_TRACEFILE=<file path> - csak akkor van hatása, ha a nyomkövetés engedélyezve van a beállítással COREHOST_TRACE=1. Ha be van állítva, a nyomkövetési adatok a megadott fájlba lesznek írva; ellenkező esetben a nyomkövetési adatok a következőre lesznek stderrírva: .
COREHOST_TRACE_VERBOSITY=[1/2/3/4]- az alapértelmezett érték.4 A beállítás csak akkor használatos, ha a nyomkövetés engedélyezve van a következőn keresztül COREHOST_TRACE=1: .
- 4 - minden nyomkövetési információ meg van írva
- 3 - csak tájékoztató, figyelmeztető és hibaüzenetek vannak megírva
- 2 - csak figyelmeztetések és hibaüzenetek vannak megírva
- 1 - csak a hibaüzenetek írása

Az alkalmazás indításával kapcsolatos részletes nyomkövetési információk lekérésének tipikus módja az alkalmazás beállítása COREHOST_TRACE=1 ésCOREHOST_TRACEFILE=host_trace.txt futtatása. A rendszer létrehoz egy új fájlt host_trace.txt az aktuális könyvtárban a részletes információkkal.

`SuppressNETCoreSdkPreviewMessage`

Ha be van trueállítva, az invoking dotnet nem fog figyelmeztetést generálni, ha előzetes verziójú SDK-t használ.

Az MSBuild konfigurálása a .NET parancssori felületén

Az MSBuild folyamaton kívüli végrehajtásához állítsa a DOTNET_CLI_RUN_MSBUILD_OUTOFPROC környezeti változót a következőre 1: , truevagy yes. Alapértelmezés szerint az MSBuild in-proc hajtja végre. Ha azt szeretné, hogy az MSBuild egy hosszú élettartamú külső munkacsomópontot használjon projektek létrehozásához, állítsa be DOTNET_CLI_USE_MSBUILDNOINPROCNODE1az , truevagy yes. Ezzel a környezeti változót MSBUILDNOINPROCNODE az MSBuild Server V1 értékre 1állítja, mivel a belépési folyamat a munka nagy részét továbbítja neki.

`DOTNET_MSBUILD_SDK_RESOLVER_*`

Ezek olyan felülbírálások, amelyek arra kényszerítik a feloldott SDK-feladatokat és célokat, hogy egy adott alapkönyvtárból érkezzenek, és egy adott verziót jelentsenek az MSBuildnek, amely ismeretlen lehet null . Ehhez az egyik legfontosabb használati eset az SDK-tevékenységek és -célok tesztelése anélkül, hogy üzembe helyezték őket a .NET Core SDK használatával.

DOTNET_MSBUILD_SDK_RESOLVER_SDKS_DIR: Felülbírálja a .NET SDK-könyvtárat.
DOTNET_MSBUILD_SDK_RESOLVER_SDKS_VER: Felülbírálja a .NET SDK-verziót.
DOTNET_MSBUILD_SDK_RESOLVER_CLI_DIR: Felülbírálja a dotnet.exe könyvtár elérési útját.

`DOTNET_NEW_PREFERRED_LANG`

A kapcsoló kihagyásakor konfigurálja a dotnet new parancs -lang|--language alapértelmezett programozási nyelvét. Az alapértelmezett érték C#. Az érvényes értékek a következők C#: , F#vagy VB. További információ: dotnet new.

`dotnet watch` környezeti változók

A környezeti változókként elérhető beállításokról dotnet watch további információt a dotnet watch környezeti változóiban talál.

.NET környezeti változók

.NET futtatókörnyezet környezeti változói

DOTNET_SYSTEM_NET_HTTP_*

DOTNET_SYSTEM_GLOBALIZATION_*

Invariáns mód beállítása

DOTNET_SYSTEM_GLOBALIZATION_USENLS

DOTNET_SYSTEM_NET_SOCKETS_*

DOTNET_SYSTEM_NET_DISABLEIPV6

DOTNET_SYSTEM_NET_HTTP_USESOCKETSHTTPHANDLER

DOTNET_Jit* és DOTNET_GC*

JIT-stressz

GC-furat terhelése

JIT memóriakorlátok

DOTNET_RUNNING_IN_CONTAINER és DOTNET_RUNNING_IN_CONTAINERS

DOTNET_SYSTEM_CONSOLE_ALLOW_ANSI_COLOR_REDIRECTION

DOTNET_SYSTEM_DIAGNOSTICS és kapcsolódó változók

DOTNET_DiagnosticPorts

DOTNET_DefaultDiagnosticPortSuspend

DOTNET_EnableDiagnostics

DOTNET_EnableDiagnostics_IPC

DOTNET_EnableDiagnostics_Debugger

DOTNET_EnableDiagnostics_Profiler

EventPipe-változók

.NET SDK és CLI környezeti változók

DOTNET_ROOT, DOTNET_ROOT(x86)

DOTNET_HOST_PATH

DOTNET_LAUNCH_PROFILE

NUGET_PACKAGES

DOTNET_SERVICING

DOTNET_NOLOGO

DOTNET_CLI_PERF_LOG

DOTNET_GENERATE_ASPNET_CERTIFICATE

DOTNET_ADD_GLOBAL_TOOLS_TO_PATH

DOTNET_CLI_TELEMETRY_OPTOUT

DOTNET_SKIP_FIRST_TIME_EXPERIENCE

DOTNET_MULTILEVEL_LOOKUP

DOTNET_ROLL_FORWARD

DOTNET_ROLL_FORWARD_TO_PRERELEASE

DOTNET_ROLL_FORWARD_ON_NO_CANDIDATE_FX

DOTNET_CLI_FORCE_UTF8_ENCODING

DOTNET_CLI_UI_LANGUAGE

DOTNET_DISABLE_GUI_ERRORS

DOTNET_ADDITIONAL_DEPS

DOTNET_RUNTIME_ID

DOTNET_SHARED_STORE

DOTNET_STARTUP_HOOKS

DOTNET_BUNDLE_EXTRACT_BASE_DIR

DOTNET_CLI_CONTEXT_*

DOTNET_CLI_WORKLOAD_UPDATE_NOTIFY_DISABLE

DOTNET_CLI_WORKLOAD_UPDATE_NOTIFY_INTERVAL_HOURS

DOTNET_TOOLS_ALLOW_MANIFEST_IN_ROOT

COREHOST_TRACE

SuppressNETCoreSdkPreviewMessage

Az MSBuild konfigurálása a .NET parancssori felületén

DOTNET_MSBUILD_SDK_RESOLVER_*

DOTNET_NEW_PREFERRED_LANG

dotnet watch környezeti változók

Kapcsolódó információk

Visszajelzés

További források

`DOTNET_SYSTEM_NET_HTTP_*`

`DOTNET_SYSTEM_GLOBALIZATION_*`

`DOTNET_SYSTEM_GLOBALIZATION_USENLS`

`DOTNET_SYSTEM_NET_SOCKETS_*`

`DOTNET_SYSTEM_NET_DISABLEIPV6`

`DOTNET_SYSTEM_NET_HTTP_USESOCKETSHTTPHANDLER`

`DOTNET_Jit` és `DOTNET_GC`

`DOTNET_RUNNING_IN_CONTAINER` és `DOTNET_RUNNING_IN_CONTAINERS`

`DOTNET_SYSTEM_CONSOLE_ALLOW_ANSI_COLOR_REDIRECTION`

`DOTNET_SYSTEM_DIAGNOSTICS` és kapcsolódó változók

`DOTNET_DiagnosticPorts`

`DOTNET_DefaultDiagnosticPortSuspend`

`DOTNET_EnableDiagnostics`

`DOTNET_EnableDiagnostics_IPC`

`DOTNET_EnableDiagnostics_Debugger`

`DOTNET_EnableDiagnostics_Profiler`

`DOTNET_ROOT`, `DOTNET_ROOT(x86)`

`DOTNET_HOST_PATH`

`DOTNET_LAUNCH_PROFILE`

`NUGET_PACKAGES`

`DOTNET_SERVICING`

`DOTNET_NOLOGO`

`DOTNET_CLI_PERF_LOG`

`DOTNET_GENERATE_ASPNET_CERTIFICATE`

`DOTNET_ADD_GLOBAL_TOOLS_TO_PATH`

`DOTNET_CLI_TELEMETRY_OPTOUT`

`DOTNET_SKIP_FIRST_TIME_EXPERIENCE`

`DOTNET_MULTILEVEL_LOOKUP`

`DOTNET_ROLL_FORWARD`

`DOTNET_ROLL_FORWARD_TO_PRERELEASE`

`DOTNET_ROLL_FORWARD_ON_NO_CANDIDATE_FX`

`DOTNET_CLI_FORCE_UTF8_ENCODING`

`DOTNET_CLI_UI_LANGUAGE`

`DOTNET_DISABLE_GUI_ERRORS`

`DOTNET_ADDITIONAL_DEPS`

`DOTNET_RUNTIME_ID`

`DOTNET_SHARED_STORE`

`DOTNET_STARTUP_HOOKS`

`DOTNET_BUNDLE_EXTRACT_BASE_DIR`

`DOTNET_CLI_CONTEXT_*`

`DOTNET_CLI_WORKLOAD_UPDATE_NOTIFY_DISABLE`

`DOTNET_CLI_WORKLOAD_UPDATE_NOTIFY_INTERVAL_HOURS`

`DOTNET_TOOLS_ALLOW_MANIFEST_IN_ROOT`

`COREHOST_TRACE`

`SuppressNETCoreSdkPreviewMessage`

`DOTNET_MSBUILD_SDK_RESOLVER_*`

`DOTNET_NEW_PREFERRED_LANG`

`dotnet watch` környezeti változók