.NET-miljövariabler

Den här artikeln gäller för: ✔️ .NET 6 SDK och senare versioner

I den här artikeln får du lära dig mer om de miljövariabler som används av .NET. Vissa miljövariabler används av .NET-körningen, medan andra endast används av .NET SDK och .NET CLI. Vissa miljövariabler används av alla tre komponenterna.

Miljövariabler för .NET-körning

DOTNET_SYSTEM_NET_HTTP_*

Det finns flera globala inställningar för HTTP-miljövariabler:

• DOTNET_SYSTEM_NET_HTTP_ENABLEACTIVITYPROPAGATION
  • Anger om du vill aktivera aktivitetsspridning för diagnostikhanteraren för globala HTTP-inställningar.
• DOTNET_SYSTEM_NET_HTTP_SOCKETSHTTPHANDLER_HTTP2SUPPORT
  • När värdet är inställt på false eller 0inaktiverar du HTTP/2-stöd, vilket är aktiverat som standard.
• DOTNET_SYSTEM_NET_HTTP_SOCKETSHTTPHANDLER_HTTP3SUPPORT
  • När värdet är inställt på true eller 1aktiverar du HTTP/3-stöd, vilket är inaktiverat som standard.
• DOTNET_SYSTEM_NET_HTTP_SOCKETSHTTPHANDLER_HTTP2FLOWCONTROL_DISABLEDYNAMICWINDOWSIZING
  • När det är inställt på false eller 0åsidosätter du standardvärdet och inaktiverar algoritmen för dynamisk skalning av HTTP/2-fönster.
• DOTNET_SYSTEM_NET_HTTP_SOCKETSHTTPHANDLER_FLOWCONTROL_MAXSTREAMWINDOWSIZE
  • Standardvärdet är 16 MB. När den åsidosätts får den maximala storleken på HTTP/2-strömmens mottagningsfönster inte vara mindre än 65 535.
• DOTNET_SYSTEM_NET_HTTP_SOCKETSHTTPHANDLER_FLOWCONTROL_STREAMWINDOWSCALETHRESHOLDMULTIPLIER
  • Standardvärdet är 1.0. Vid åsidosättande resulterar högre värden i ett kortare fönster men långsammare nedladdningar. Får inte vara mindre än 0.

DOTNET_SYSTEM_GLOBALIZATION_*

• DOTNET_SYSTEM_GLOBALIZATION_INVARIANT: Se ange invariant läge.
• DOTNET_SYSTEM_GLOBALIZATION_PREDEFINED_CULTURES_ONLY: Anger om endast fördefinierade kulturer ska läsas in.
• DOTNET_SYSTEM_GLOBALIZATION_APPLOCALICU: Anger om du vill använda de applokala internationella komponenterna i Unicode (ICU). Mer information finns i Applokal ICU.

Ange invariant läge

Program kan aktivera det invarianta läget på något av följande sätt:

1. I projektfilen:

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

2. I filen runtimeconfig.json :

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

3. Genom att ange miljövariabelvärdet DOTNET_SYSTEM_GLOBALIZATION_INVARIANT till true eller 1.

Mer information finns i .NET Globalisering invariant läge.

DOTNET_SYSTEM_GLOBALIZATION_USENLS

Detta gäller endast för Windows. Om du vill att globalisering ska använda National Language Support (NLS) anger du DOTNET_SYSTEM_GLOBALIZATION_USENLS till antingen true eller 1. Om du inte vill använda den anger du DOTNET_SYSTEM_GLOBALIZATION_USENLS till antingen false eller 0.

DOTNET_SYSTEM_NET_SOCKETS_*

Det här avsnittet fokuserar på två System.Net.Sockets miljövariabler:

• DOTNET_SYSTEM_NET_SOCKETS_INLINE_COMPLETIONS
• DOTNET_SYSTEM_NET_SOCKETS_THREAD_COUNT

Socket-fortsättningar skickas till System.Threading.ThreadPool från händelsetråden. Detta förhindrar fortsättningar som blockerar händelsehanteringen. Om du vill tillåta fortsättningar att köras direkt i händelsetråden anger du DOTNET_SYSTEM_NET_SOCKETS_INLINE_COMPLETIONS till 1. Som standard är den inaktiverad.

Med Hjälp av TechEmpower-benchmarks som genererar många små socketläsningar och skrivningar under mycket hög belastning, kan en enda socketmotor hålla upptaget upp till trettio x64 och åtta Arm64 CPU-kärnor. De allra flesta verkliga scenarier kommer aldrig att generera en så stor belastning (hundratusentals begäranden per sekund), och att ha en enda producent räcker nästan alltid. Men för att vara säker på att extrema belastningar kan hanteras kan du använda DOTNET_SYSTEM_NET_SOCKETS_THREAD_COUNT för att åsidosätta det beräknade värdet. När det inte åsidosättas används följande värde:

• När DOTNET_SYSTEM_NET_SOCKETS_INLINE_COMPLETIONS är 1Environment.ProcessorCount används värdet.
• När DOTNET_SYSTEM_NET_SOCKETS_INLINE_COMPLETIONS är inte 1utvärderas RuntimeInformation.ProcessArchitecture :
  • När arm- eller Arm64-kärnorna per motorvärde är inställt på 8, annars 30.
• Med hjälp av de fastställda kärnorna per motor, det maximala värdet för antingen 1 eller Environment.ProcessorCount över kärnorna per motor.

DOTNET_SYSTEM_NET_DISABLEIPV6

Hjälper dig att avgöra om Internet Protocol version 6 (IPv6) är inaktiverad eller inte. När det är inställt på antingen true eller 1inaktiveras IPv6 om inget annat anges i System.AppContext.

DOTNET_SYSTEM_NET_HTTP_USESOCKETSHTTPHANDLER

Du kan använda någon av följande mekanismer för att konfigurera en process för att använda den äldre HttpClientHandler:

Använd klassen från kod AppContext :

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

Växeln AppContext kan också ställas in av en konfigurationsfil. Mer information om hur du konfigurerar växlar finns i AppContext för bibliotekskonsumenter.

Samma sak kan uppnås via miljövariabeln DOTNET_SYSTEM_NET_HTTP_USESOCKETSHTTPHANDLER. Om du vill välja bort anger du värdet till antingen false eller 0.

DOTNET_RUNNING_IN_CONTAINER och DOTNET_RUNNING_IN_CONTAINERS

De officiella .NET-avbildningarna (Windows och Linux) anger de välkända miljövariablerna:

• DOTNET_RUNNING_IN_CONTAINER
• DOTNET_RUNNING_IN_CONTAINERS

Dessa värden används för att avgöra när dina ASP.NET Core-arbetsbelastningar körs i kontexten för en container.

DOTNET_SYSTEM_CONSOLE_ALLOW_ANSI_COLOR_REDIRECTION

När Console.IsOutputRedirected är truekan du generera ANSI-färgkod genom att ange DOTNET_SYSTEM_CONSOLE_ALLOW_ANSI_COLOR_REDIRECTION antingen 1 eller true.

DOTNET_SYSTEM_DIAGNOSTICS och relaterade variabler

• DOTNET_SYSTEM_DIAGNOSTICS_DEFAULTACTIVITYIDFORMATISHIERARCHIAL: När 1 eller trueär standardformatet för aktivitets-ID hierarkiskt.
• DOTNET_SYSTEM_RUNTIME_CACHING_TRACING: När du kör som felsökning kan spårning aktiveras när detta är true.

DOTNET_DiagnosticPorts

Konfigurerar alternativa slutpunkter där diagnostikverktyg kan kommunicera med .NET-körningen. Mer information finns i dokumentationen om diagnostikporten.

DOTNET_DefaultDiagnosticPortSuspend

Konfigurerar körningen så att den pausar under starten och väntar på kommandot Diagnostics IPC ResumeStartup från den angivna diagnostikporten när den är inställd på 1. Standardvärdet är 0. Mer information finns i dokumentationen om diagnostikporten.

DOTNET_EnableDiagnostics

När inställningen är inställd 0på inaktiverar du felsökning, profilering och annan diagnostik via diagnostikportenoch kan inte åsidosättas av andra diagnostikinställningar. Standardvärdet är 1.

DOTNET_EnableDiagnostics_IPC

Från och med .NET 8 inaktiveras diagnostikporten0är inställd på och kan inte åsidosättas av andra diagnostikinställningar. Standardvärdet är 1.

DOTNET_EnableDiagnostics_Debugger

Om du börjar med .NET 8 inaktiveras felsökning och kan inte åsidosättas av andra diagnostikinställningar när det är inställt 0på . Standardvärdet är 1.

DOTNET_EnableDiagnostics_Profiler

Från och med .NET 8 inaktiverar profilering och kan inte åsidosättas av andra diagnostikinställningar när det är inställt på 0. Standardvärdet är 1.

EventPipe-variabler

Mer information finns i Miljövariabler för EventPipe.

• DOTNET_EnableEventPipe: När värdet är 1inställt på aktiverar du spårning via EventPipe.
• DOTNET_EventPipeOutputPath: Den utdatasökväg där spårningen kommer att skrivas.
• DOTNET_EventPipeOutputStreaming: När värdet är inställt 1på aktiverar du direktuppspelning till utdatafilen medan appen körs. Som standard ackumuleras spårningsinformation i en cirkulär buffert och innehållet skrivs vid appavstängning.

Miljövariabler för .NET SDK och CLI

DOTNET_ROOT, DOTNET_ROOT(x86), , DOTNET_ROOT_X86DOTNET_ROOT_X64

Anger platsen för .NET-körningen, om de inte är installerade på standardplatsen. Standardplatsen i Windows är C:\Program Files\dotnet. Standardplatsen på macOS är /usr/local/share/dotnet. Standardplatsen för x64-körningarna i ett arm64-operativsystem är under en x64-undermapp (så C:\Program Files\dotnet\x64 på Windows och /usr/local/share/dotnet/x64 macOS. Standardplatsen för Linux varierar beroende på distributions- och avbetalningsmetod. Standardplatsen på Ubuntu 22.04 är /usr/share/dotnet (när den installeras från packages.microsoft.com) eller /usr/lib/dotnet (när den installeras från Jammy-feeden). Mer information finns i följande resurser:

• Felsöka appstartfel
• GitHub-problem med dotnet/core#7699
• GitHub-problem med dotnet/runtime#79237

Dessa miljövariabler används endast när appar körs via genererade körbara filer (apphosts). I vilken ordning miljövariablerna beaktas är:

1. DOTNET_ROOT_<ARCH>, där <ARCH> är arkitekturen för den körbara körbara filen (apphost). Till exempel:
   • DOTNET_ROOT_ARM64 används för en Arm64-process.
   • DOTNET_ROOT_X64 används för en x64-process. Den här processen kan köras på x64- eller Arm64-arkitekturen.
   • DOTNET_ROOT_X86 används för en x86-process. Den här processen kan köras på x86- eller x64-arkitekturen.
2. DOTNET_ROOT(x86) används när en 32-bitarsprocess körs på 64-bitars Windows. I andra fall ignoreras den här miljövariabeln.
3. DOTNET_ROOT.

DOTNET_HOST_PATH

Anger den absoluta sökvägen till en dotnet värd (dotnet.exe i Windows, dotnet i Linux och macOS) som användes för att starta den process som körs dotnet för närvarande. Detta används av .NET SDK för att hjälpa verktyg som körs under .NET SDK-kommandon att se till att de använder samma dotnet körning för alla underordnade dotnet processer som de skapar under kommandots varaktighet. Verktyg och MSBuild-uppgifter i SDK som anropar binärfiler via dotnet värden förväntas uppfylla den här miljövariabeln för att säkerställa en konsekvent upplevelse.

Verktyg som anropar dotnet under ett SDK-kommando bör använda följande algoritm för att hitta den:

• om DOTNET_HOST_PATH anges använder du det värdet direkt
• i annat fall kan du förlita dig på dotnet systemets PATH

DOTNET_LAUNCH_PROFILE

Kommandot dotnet run anger den här variabeln till den valda startprofilen.

Med följande launchSettings.json fil:

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

Och följande Program.cs fil:

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

Följande scenarier genererar utdata som visas:

• Startprofilen har angetts och finns

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

• Startprofilen har inte angetts, först en markerad

  $ dotnet run
  DOTNET_LAUNCH_PROFILE=First
  

• Startprofilen har angetts men finns inte

  $ 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=
  

• Starta utan profil

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

NUGET_PACKAGES

Mappen globala paket. Om den inte är inställd är den som standard ~/.nuget/packages på Unix eller %userprofile%\.nuget\packages i Windows.

DOTNET_SERVICING

Anger platsen för serviceindexet som ska användas av den delade värden när körningen läses in.

DOTNET_NOLOGO

Anger om .NET-välkomst- och telemetrimeddelanden ska visas vid den första körningen. Ställ in på för att true stänga av dessa meddelanden (värden true, 1eller yes accepterade) eller inställt på att false tillåta dem (värden false, 0eller no accepterade). Om det inte anges är false standardvärdet och meddelandena visas vid den första körningen. Den här flaggan påverkar inte telemetri (se DOTNET_CLI_TELEMETRY_OPTOUT för att välja bort att skicka telemetri).

DOTNET_CLI_PERF_LOG

Anger om prestandainformation om den aktuella CLI-sessionen loggas. Aktiverad när den är inställd på 1, trueeller yes. Alternativet är inaktiverat som standard.

DOTNET_GENERATE_ASPNET_CERTIFICATE

Anger om du vill generera ett ASP.NET Core-certifikat. Standardvärdet är true, men det kan åsidosättas genom att ställa in miljövariabeln på antingen 0, falseeller no.

DOTNET_ADD_GLOBAL_TOOLS_TO_PATH

Anger om du vill lägga till globala verktyg i PATH miljövariabeln. Standardvärdet är true. Om du inte vill lägga till globala verktyg i sökvägen anger du till 0, falseeller no.

DOTNET_CLI_TELEMETRY_OPTOUT

Anger om data om .NET-verktygsanvändningen samlas in och skickas till Microsoft. Ställ in på för att true välja bort telemetrifunktionen (värden true, 1eller yes accepterade). Annars ställer du in false på för att välja telemetrifunktioner (värden false, 0eller no accepterade). Om den inte anges är false standardinställningen och telemetrifunktionen är aktiv.

DOTNET_SKIP_FIRST_TIME_EXPERIENCE

Om DOTNET_SKIP_FIRST_TIME_EXPERIENCE är inställt på trueexpanderas inte disken NuGetFallbackFolder och ett kortare välkomstmeddelande och telemetrimeddelande visas.

DOTNET_MULTILEVEL_LOOKUP

Anger om .NET-körningen, det delade ramverket eller SDK:t matchas från den globala platsen. Om den inte anges är standardvärdet 1 (logisk true). Ange värdet till 0 (logisk false) för att inte matcha från den globala platsen och ha isolerade .NET-installationer. Mer information om uppslag på flera nivåer finns i SharedFX-sökning på flera nivåer.

DOTNET_ROLL_FORWARD

Bestämmer beteendet för vidarekoppling. Mer information finns i --roll-forward alternativet för dotnet kommandot.

DOTNET_ROLL_FORWARD_TO_PRERELEASE

Om inställningen är inställd på 1 (aktiverad) aktiverar du vidarekoppling till en förhandsversion från en versionsversion. Som standard (0 - inaktiverad), när en versionsversion av .NET-körning begärs, kommer roll-forward endast att överväga installerade versionsversioner.

Mer information finns i --roll-forward alternativet för dotnet kommandot.

DOTNET_CLI_FORCE_UTF8_ENCODING

Tvingar användning av UTF-8-kodning i konsolen, även för äldre versioner av Windows 10 som inte har fullt stöd för UTF-8. Mer information finns i SDK:n ändrar inte längre konsolkodning när den är klar.

DOTNET_CLI_UI_LANGUAGE

Anger språket i CLI-användargränssnittet med hjälp av ett språkvärde, till exempel en-us. De värden som stöds är desamma som för Visual Studio. Mer information finns i avsnittet om hur du ändrar installationsspråket i installationsdokumentationen för Visual Studio. .NET Resource Manager-reglerna gäller, så du behöver inte välja en exakt matchning – du kan också välja underordnade i CultureInfo trädet. Om du till exempel ställer in den på fr-CAkommer CLI att hitta och använda översättningarna fr . Om du ställer in det på ett språk som inte stöds återgår CLI till engelska.

DOTNET_DISABLE_GUI_ERRORS

För GUI-aktiverade genererade körbara filer inaktiverar popup-dialogrutan, som normalt visas för vissa felklasser. Den skriver bara till stderr och avslutar i dessa fall.

DOTNET_ADDITIONAL_DEPS

Motsvarar CLI-alternativet --additional-deps.

DOTNET_RUNTIME_ID

Åsidosätter identifierade RID.

DOTNET_SHARED_STORE

Plats för det "delade arkivet" som sammansättningsupplösningen i vissa fall återgår till.

DOTNET_STARTUP_HOOKS

Lista över sammansättningar som ska läsas in och köra startkrokar från.

DOTNET_BUNDLE_EXTRACT_BASE_DIR

Anger en katalog som ett enfilsprogram extraheras till innan det körs.

Mer information finns i Körbara filer med en fil.

DOTNET_CLI_HOME

Anger den plats som stödfiler för .NET CLI-kommandon ska skrivas till. Till exempel:

• Användarskrivningsbara sökvägar för arbetsbelastningspaket, manifest och andra stöddata.
• Första körningen av sentinel-/låsfiler för aspekter av .NET CLI:s första körningsmigreringar och meddelandeupplevelser.
• Standardinstallationsplatsen för det lokala .NET-verktyget.

DOTNET_CLI_CONTEXT_*

• DOTNET_CLI_CONTEXT_VERBOSE: Om du vill aktivera en utförlig kontext anger du till true.
• DOTNET_CLI_CONTEXT_ANSI_PASS_THRU: Om du vill aktivera en ANSI-genomströmning anger du till true.

DOTNET_CLI_WORKLOAD_UPDATE_NOTIFY_DISABLE

Inaktiverar bakgrundsnedladdning av reklammanifest för arbetsbelastningar. Standardvärdet är false – inte inaktiverat. Om värdet är inställt på trueinaktiveras nedladdningen. Mer information finns i Annonseringsmanifest.

DOTNET_CLI_WORKLOAD_UPDATE_NOTIFY_INTERVAL_HOURS

Anger det minsta antalet timmar mellan bakgrundsnedladdningar av reklammanifest för arbetsbelastningar. Standardvärdet är 24, som inte är oftare än en gång om dagen. Mer information finns i Annonseringsmanifest.

DOTNET_TOOLS_ALLOW_MANIFEST_IN_ROOT

Anger om lokala .NET SDK-verktyg söker efter verktygsmanifestfiler i rotmappen i Windows. Standardvärdet är false.

DOTNET_HOST_TRACE

Den här variabeln gäller för .NET 10 och senare versioner. För äldre versioner ersätter du prefixet DOTNET_HOST_ med COREHOST_.

Styr diagnostikspårning från värdkomponenterna, till exempel dotnet.exe, hostfxroch hostpolicy.

• DOTNET_HOST_TRACE=[0/1] - standard är 0 - spårning inaktiverad. Om värdet 1är aktiverat aktiveras spårning av diagnostik.

• DOTNET_HOST_TRACEFILE=<file path> – har bara en effekt om spårning är aktiverat genom att ange DOTNET_HOST_TRACE=1. När den anges skrivs spårningsinformationen till den angivna filen. annars skrivs spårningsinformationen till stderr.

• DOTNET_HOST_TRACE_VERBOSITY=[1/2/3/4] – standardvärdet är 4. Inställningen används endast när spårning är aktiverat via DOTNET_HOST_TRACE=1.

  • 4 – all spårningsinformation är skriven
  • 3 – endast informations-, varnings- och felmeddelanden skrivs
  • 2 – endast varnings- och felmeddelanden skrivs
  • 1 – endast felmeddelanden skrivs

Det vanliga sättet att få detaljerad spårningsinformation om programstart är att ange DOTNET_HOST_TRACE=1 och DOTNET_HOST_TRACEFILE=host_trace.txt sedan köra programmet. En ny fil host_trace.txt skapas i den aktuella katalogen med detaljerad information.

COREHOST_TRACE

Styr diagnostikspårning från värdkomponenterna, till exempel dotnet.exe, hostfxroch hostpolicy.

• COREHOST_TRACE - Se DOTNET_HOST_TRACE.
• COREHOST_TRACEFILE - Se DOTNET_HOST_TRACEFILE.
• COREHOST_TRACE_VERBOSITY - Se DOTNET_HOST_TRACE_VERBOSITY.

SuppressNETCoreSdkPreviewMessage

Om värdet är inställt truepå dotnet genereras ingen varning när en förhandsversions-SDK används.

Konfigurera MSBuild i .NET CLI

Om du vill köra MSBuild out-of-process anger du DOTNET_CLI_RUN_MSBUILD_OUTOFPROC miljövariabeln till antingen 1, trueeller yes. Som standard körs MSBuild i processen. Om du vill tvinga MSBuild att använda en extern arbetsnods långvariga process för att skapa projekt anger du DOTNET_CLI_USE_MSBUILDNOINPROCNODE till 1, trueeller yes. Detta anger MSBUILDNOINPROCNODE miljövariabeln till 1, som kallas MSBuild Server V1, eftersom inmatningsprocessen vidarebefordrar det mesta av arbetet till den.

DOTNET_MSBUILD_SDK_RESOLVER_*

Det här är åsidosättningar som används för att tvinga de lösta SDK-uppgifterna och målen att komma från en viss baskatalog och rapportera en viss version till MSBuild, vilket kan vara om det är null okänt. Ett viktigt användningsfall för detta är att testa SDK-uppgifter och mål utan att distribuera dem med hjälp av .NET Core SDK.

• DOTNET_MSBUILD_SDK_RESOLVER_SDKS_DIR: Åsidosätter .NET SDK-katalogen.
• DOTNET_MSBUILD_SDK_RESOLVER_SDKS_VER: Åsidosätter .NET SDK-versionen.
• DOTNET_MSBUILD_SDK_RESOLVER_CLI_DIR: Åsidosätter dotnet.exe katalogsökväg.

DOTNET_NEW_PREFERRED_LANG

Konfigurerar standardprogrammeringsspråket dotnet new för kommandot när växeln -lang|--language utelämnas. Standardvärdet är C#. Giltiga värden är C#, F#eller VB. Mer information finns i dotnet new.

dotnet watch Miljövariabler

Information om dotnet watch inställningar som är tillgängliga som miljövariabler finns i miljövariabler för dotnet watch.

Se även

• dotnet-kommando
• Körningskonfigurationsfiler
• Konfigurationsinställningar för .NET-körning