Megosztás a következőn keresztül:

.NET környezeti változó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

Ez a szakasz a következő környezeti változókat határozza meg:

A .NET-futtatókörnyezet konfigurálásáról további információt a .NET-futtatókörnyezet konfigurációs beállításaiban talál.

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 true, engedélyezi a 1 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:

  1. A projektfájlban:

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

  2. A runtimeconfig.json fájlban:

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

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

Important

A projektfájlban vagy a runtimeconfig.json megadott értékek prioritása magasabb, 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 true1 . 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.

Note

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.

Note

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

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_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

Ez a szakasz a következő környezeti változókat ismerteti:

DOTNET_ROOT, DOTNET_ROOT(x86), DOTNET_ROOT_X86DOTNET_ROOT_X64

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: . Az arm64 operációs rendszeren az x64-futtatókörnyezetek alapértelmezett helye egy x64-almappában van (így C:\Program Files\dotnet\x64 windowson és /usr/local/share/dotnet/x64 macOS rendszeren is). 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ót a következő források tartalmaznak:

Ezek a környezeti változók csak akkor használatosak, ha az alkalmazásokat generált végrehajtható eszközök (apphostok) használatával futtatják. A környezeti változók figyelembe vett sorrendje a következő:

  1. DOTNET_ROOT_<ARCH>, hol <ARCH> található a futtatható futtatható (apphost) architektúrája. Például:
    • DOTNET_ROOT_ARM64 Arm64-folyamathoz használható.
    • DOTNET_ROOT_X64 x64-folyamathoz használható. Ez a folyamat x64- vagy Arm64-architektúrán futhat.
    • DOTNET_ROOT_X86 x86-folyamathoz használatos. Ez a folyamat x86-os vagy x64-architektúrán futhat.
  2. DOTNET_ROOT(x86) akkor használatos, ha egy 32 bites folyamat 64 bites Windows rendszeren fut. Más esetekben a környezeti változó figyelmen kívül lesz hagyva.
  3. DOTNET_ROOT.

DOTNET_HOST_PATH

Megadja a gazdagép abszolút elérési útját dotnet (dotnet.exe Windowson, dotnet Linuxon és macOS rendszeren). Ez az elérési út az aktuálisan futó dotnet folyamat elindításához használt gazdagépet, vagy azt a gazdagépet jelöli, amelyet az msBuild alatt történő végrehajtáskor az aktuális projekt parancsainak futtatásakor dotnet használna. A .NET SDK ezzel a változóval segíti a .NET SDK-parancsok során futó eszközöket, hogy ugyanazt dotnet a gazdagépkonfigurációt használják a parancs időtartamára létrehozott gyermekfolyamatokhoz dotnet . Az eszközöknek és az MSBuild-logikának, amelyek egy buildben futnak, és bináris fájlokat hívnak meg a gazdagépen keresztül, elvárják, hogy betartják ezt a dotnet környezeti változót a konzisztens élmény biztosítása érdekében.

A Visual Studio 2026-tól kezdődően a Visual Studióban az MSBuild is biztosítja, hogy DOTNET_HOST_PATH a .NET SDK-projektek összes buildje be legyen állítva. A legnagyobb konzisztencia érdekében minden OLYAN MSBuild-eszköznek és logikának, amely ugyanazt a dotnet bináris fájlt szeretné használni, mint amelyik a buildet generálta, támaszkodnia DOTNET_HOST_PATH kell, és érdemes megfontolnia egy diagnosztikai (figyelmeztetés vagy hiba) kibocsájtást, ha a változó nincs jelen.

Note

DOTNET_HOST_PATH nem általános megoldás a gazdagép helyének dotnet tárolására. Csak a .NET SDK vagy az MSBuild által meghívott bináris fájlok és 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.

Tekintettel a következő launchSettings.json fájlra:

{
  "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.

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.

Note

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.

Note

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 --roll-forward 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 tekintse meg --roll-forward beállításátdotnet.

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_HOME

Megadja azt a helyet, ahová a .NET CLI-parancsok támogató fájljait meg kell írni. Például:

  • Felhasználó által írható elérési utak számítási feladatcsomagokhoz, jegyzékekhez és egyéb támogató adatokhoz.
  • Az első futtatású sentinel/lock fájlok a .NET CLI első futtatású migrálási és értesítési funkcióinak aspektusaihoz.
  • Az alapértelmezett .NET helyi eszköztelepítési hely.

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_SKIP_WORKLOAD_INTEGRITY_CHECK

Megadja, hogy a számítási feladatok integritásának ellenőrzése első futtatáskor kihagyható-e. Az integritás-ellenőrzés biztosítja, hogy a korábbi funkciósávok számítási feladatai elérhetők legyenek a jelenleg telepített SDK-hoz. Állítsa be az értéket true, 1vagy yes hagyja ki az ellenőrzést. Az alapértelmezett érték falseaz integritás ellenőrzése.

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.

DOTNET_HOST_TRACE

Ez a változó a .NET 10 és újabb verziókra vonatkozik. Régebbi verziók esetén cserélje le az előtagot a DOTNET_HOST_ következőre COREHOST_: .

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

  • DOTNET_HOST_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.

  • DOTNET_HOST_TRACEFILE=<file path> - csak akkor van hatása, ha a nyomkövetés engedélyezve van a beállítással DOTNET_HOST_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: .

  • DOTNET_HOST_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 DOTNET_HOST_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 DOTNET_HOST_TRACE=1 és DOTNET_HOST_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.

COREHOST_TRACE

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

Note

A .NET 10-től kezdve használja inkább a DOTNET_HOST_TRACE környezeti változókat. A COREHOST_TRACE változók ugyanúgy működnek, mint a DOTNET_HOST_TRACE változók.

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.

Lásd még

  • Last updated on