Share via


.NET-omgevingsvariabelen

Dit artikel is van toepassing op: ✔️ .NET Core 3.1 SDK en latere versies

In dit artikel vindt u informatie over de omgevingsvariabelen die door .NET worden gebruikt. Sommige omgevingsvariabelen worden gebruikt door de .NET-runtime, terwijl andere alleen worden gebruikt door de .NET SDK en .NET CLI. Sommige omgevingsvariabelen worden gebruikt door alle drie de onderdelen.

Omgevingsvariabelen voor .NET Runtime

DOTNET_SYSTEM_NET_HTTP_*

Er zijn verschillende globale instellingen voor de HTTP-omgevingsvariabele:

  • DOTNET_SYSTEM_NET_HTTP_ENABLEACTIVITYPROPAGATION
    • Hiermee wordt aangegeven of activiteitsdoorgifte van de diagnostische handler moet worden ingeschakeld voor globale HTTP-instellingen.
  • DOTNET_SYSTEM_NET_HTTP_SOCKETSHTTPHANDLER_HTTP2SUPPORT
    • Als deze optie is ingesteld op false of 0, wordt ondersteuning voor HTTP/2 uitgeschakeld. Deze functie is standaard ingeschakeld.
  • DOTNET_SYSTEM_NET_HTTP_SOCKETSHTTPHANDLER_HTTP3SUPPORT
    • Als deze optie is ingesteld op true of 1, wordt HTTP/3-ondersteuning ingeschakeld. Deze optie is standaard uitgeschakeld.
  • DOTNET_SYSTEM_NET_HTTP_SOCKETSHTTPHANDLER_HTTP2FLOWCONTROL_DISABLEDYNAMICWINDOWSIZING
    • Als deze optie is ingesteld op false of 0, wordt de standaardwaarde overschreven en wordt het algoritme voor dynamisch schalen van HTTP/2-vensters uitgeschakeld.
  • DOTNET_SYSTEM_NET_HTTP_SOCKETSHTTPHANDLER_FLOWCONTROL_MAXSTREAMWINDOWSIZE
    • De standaardwaarde is 16 MB. Wanneer dit wordt overschreven, mag de maximale grootte van het ontvangstvenster van de HTTP/2-stream niet kleiner zijn dan 65.535.
  • DOTNET_SYSTEM_NET_HTTP_SOCKETSHTTPHANDLER_FLOWCONTROL_STREAMWINDOWSCALETHRESHOLDMULTIPLIER
    • De standaardwaarde is 1.0. Wanneer deze wordt overschreven, resulteren hogere waarden in een korter venster, maar tragere downloads. Kan niet kleiner zijn dan 0.

DOTNET_SYSTEM_GLOBALIZATION_*

  • DOTNET_SYSTEM_GLOBALIZATION_INVARIANT: Zie de invariante modus instellen.
  • DOTNET_SYSTEM_GLOBALIZATION_PREDEFINED_CULTURES_ONLY: Hiermee geeft u op of alleen vooraf gedefinieerde culturen moeten worden geladen.
  • DOTNET_SYSTEM_GLOBALIZATION_APPLOCALICU: Geeft aan of de app-lokale International Components of Unicode (ICU) moet worden gebruikt. Zie App-local ICU voor meer informatie.

Invariantmodus instellen

Toepassingen kunnen de invariante modus op een van de volgende manieren inschakelen:

  1. In het projectbestand:

    <PropertyGroup>
        <InvariantGlobalization>true</InvariantGlobalization>
    </PropertyGroup>
    
  2. In het bestand runtimeconfig.json :

    {
        "runtimeOptions": {
            "configProperties": {
                "System.Globalization.Invariant": true
            }
        }
    }
    
  3. Door de waarde DOTNET_SYSTEM_GLOBALIZATION_INVARIANT van de omgevingsvariabele in te stellen op true of 1.

Belangrijk

Een waarde die is ingesteld in het projectbestand of runtimeconfig.json heeft een hogere prioriteit dan de omgevingsvariabele.

Zie de .NET Globalization Invariant-modus voor meer informatie.

DOTNET_SYSTEM_GLOBALIZATION_USENLS

Dit geldt alleen voor Windows. Voor globalisatie voor het gebruik van National Language Support (NLS), ingesteld DOTNET_SYSTEM_GLOBALIZATION_USENLS op of true1. Als u deze niet wilt gebruiken, stelt u deze in DOTNET_SYSTEM_GLOBALIZATION_USENLS op of false0.

DOTNET_SYSTEM_NET_SOCKETS_*

Deze sectie is gericht op twee System.Net.Sockets omgevingsvariabelen:

  • DOTNET_SYSTEM_NET_SOCKETS_INLINE_COMPLETIONS
  • DOTNET_SYSTEM_NET_SOCKETS_THREAD_COUNT

Socketvervolgingen worden verzonden naar de System.Threading.ThreadPool gebeurtenisthread. Dit voorkomt dat vervolgen de afhandeling van gebeurtenissen blokkeren. Als u wilt toestaan dat vervolgen rechtstreeks op de gebeurtenisthread worden uitgevoerd, stelt u deze in DOTNET_SYSTEM_NET_SOCKETS_INLINE_COMPLETIONS op 1. Standaard is deze instellin uitgeschakeld.

Notitie

Deze instelling kan de prestaties slechter maken als er duur werk is dat langer dan nodig is in de IO-thread. Test om ervoor te zorgen dat deze instelling de prestaties helpt.

Met Behulp van TechEmpower-benchmarks die veel kleine socketlees- en schrijfbewerkingen genereren onder een zeer hoge belasting, is een enkele socket-engine in staat om bezig te blijven tot dertig x64 en acht Arm64 CPU-kernen. De overgrote meerderheid van echte scenario's zal nooit zo'n enorme belasting genereren (honderdduizenden aanvragen per seconde) en een enkele producent is bijna altijd genoeg. Als u er echter zeker van wilt zijn dat extreme belastingen kunnen worden verwerkt, kunt u de DOTNET_SYSTEM_NET_SOCKETS_THREAD_COUNT berekende waarde overschrijven. Wanneer deze niet wordt overschreven, wordt de volgende waarde gebruikt:

  • Wanneer DOTNET_SYSTEM_NET_SOCKETS_INLINE_COMPLETIONS is 1, wordt de Environment.ProcessorCount waarde gebruikt.
  • Wanneer DOTNET_SYSTEM_NET_SOCKETS_INLINE_COMPLETIONS dit niet 1het volgende is, RuntimeInformation.ProcessArchitecture wordt het volgende geëvalueerd:
    • Wanneer Arm of Arm64 de kernen per enginewaarde is ingesteld op 8, anders 30.
  • Met behulp van de vastgestelde kernen per engine, de maximumwaarde van 1 of Environment.ProcessorCount boven de kernen per engine.

DOTNET_SYSTEM_NET_DISABLEIPV6

Hiermee kunt u bepalen of Internet Protocol versie 6 (IPv6) is uitgeschakeld. Als deze is ingesteld op of true1, wordt IPv6 uitgeschakeld, tenzij anders is opgegeven in de System.AppContext.

DOTNET_SYSTEM_NET_HTTP_USESOCKETSHTTPHANDLER

U kunt een van de volgende mechanismen gebruiken om een proces te configureren voor het gebruik van de oudere HttpClientHandler:

Gebruik de AppContext klasse vanuit code:

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

De AppContext switch kan ook worden ingesteld door een configuratiebestand. Zie AppContext voor bibliotheekgebruikers voor meer informatie over het configureren van switches.

Hetzelfde kan worden bereikt via de omgevingsvariabele DOTNET_SYSTEM_NET_HTTP_USESOCKETSHTTPHANDLER. Als u zich wilt afmelden, stelt u de waarde in op of false0.

Notitie

Vanaf .NET 5 is deze instelling die u wilt gebruiken HttpClientHandler niet meer beschikbaar.

DOTNET_Jit* en DOTNET_GC*

Er zijn twee stressgerelateerde functies voor de JIT- en JIT-gegenereerde GC-informatie: JIT Stress en GC Hole Stress. Deze functies bieden een manier tijdens de ontwikkeling om edge-cases en meer 'echte' scenario's te ontdekken zonder dat u complexe toepassingen hoeft te ontwikkelen. De volgende omgevingsvariabelen zijn beschikbaar:

  • DOTNET_JitStress
  • DOTNET_JitStressModeNamesOnly
  • DOTNET_GCStress

JIT-stress

Het inschakelen van JIT-stress kan op verschillende manieren worden uitgevoerd. Ingesteld DOTNET_JitStress op een niet-nul geheel getal om verschillende niveaus van JIT-optimalisaties te genereren op basis van een hash van de naam van de methode. Als u bijvoorbeeld alle optimalisatiesets DOTNET_JitStress=2wilt toepassen. Een andere manier om JIT Stress in te schakelen, is door de stressmodi in te stellen DOTNET_JitStressModeNamesOnly=1 en vervolgens de stressmodi aan te vragen, gescheiden door spaties, in de DOTNET_JitStressModeNames variabele.

Denk bijvoorbeeld aan:

DOTNET_JitStressModeNames=STRESS_USE_CMOV STRESS_64RSLT_MUL STRESS_LCL_FLDS

GC Hole stress

Het inschakelen van GC Hole Stress zorgt ervoor dat GCs altijd plaatsvinden op specifieke locaties en dat helpt bij het opsporen van GC-gaten. GC Hole Stress kan worden ingeschakeld met behulp van de DOTNET_GCStress omgevingsvariabele.

Zie JIT- en GC Hole-stress onderzoeken voor meer informatie.

JIT-geheugenbarrières

Met de codegenerator voor Arm64 kunnen alle MemoryBarriers instructies worden verwijderd door deze in te stellen DOTNET_JitNoMemoryBarriers op 1.

DOTNET_RUNNING_IN_CONTAINER en DOTNET_RUNNING_IN_CONTAINERS

De officiële .NET-installatiekopieën (Windows en Linux) stellen de bekende omgevingsvariabelen in:

  • DOTNET_RUNNING_IN_CONTAINER
  • DOTNET_RUNNING_IN_CONTAINERS

Deze waarden worden gebruikt om te bepalen wanneer uw ASP.NET Core-workloads worden uitgevoerd in de context van een container.

DOTNET_SYSTEM_CONSOLE_ALLOW_ANSI_COLOR_REDIRECTION

Als Console.IsOutputRedirected dat het geval is true, kunt u ANSI-kleurcode verzenden door deze in te stellen DOTNET_SYSTEM_CONSOLE_ALLOW_ANSI_COLOR_REDIRECTION op 1 of true.

  • DOTNET_SYSTEM_DIAGNOSTICS_DEFAULTACTIVITYIDFORMATISHIERARCHIAL: Wanneer 1 oftrue, de standaardindeling activiteits-id is hiërarchisch.
  • DOTNET_SYSTEM_RUNTIME_CACHING_TRACING: Bij het uitvoeren als foutopsporing kan tracering worden ingeschakeld wanneer dit is true.

DOTNET_DiagnosticPorts

Hiermee configureert u alternatieve eindpunten waar diagnostische hulpprogramma's kunnen communiceren met de .NET-runtime. Zie de documentatie voor diagnostische poort voor meer informatie.

DOTNET_DefaultDiagnosticPortSuspend

Hiermee configureert u de runtime om te onderbreken tijdens het opstarten en wacht u op de opdracht Diagnostische IPC ResumeStartup vanaf de opgegeven diagnostische poort wanneer deze is ingesteld op 1. De standaardwaarde is 0. Zie de documentatie voor diagnostische poort voor meer informatie.

DOTNET_EnableDiagnostics

Als deze instelling is ingesteld 0, schakelt u foutopsporing, profilering en andere diagnostische gegevens uit via de diagnostische poort en kan deze niet worden overschreven door andere diagnostische instellingen. Standaard ingesteld op 1.

DOTNET_EnableDiagnostics_IPC

Als u begint met .NET 8, schakelt u de 0diagnostische poort uit en kunt u deze niet overschrijven door andere diagnostische instellingen. Standaard ingesteld op 1.

DOTNET_EnableDiagnostics_Debugger

Vanaf .NET 8 wordt foutopsporing uitgeschakeld wanneer deze is ingesteld 0en kan deze niet worden overschreven door andere diagnostische instellingen. Standaard ingesteld op 1.

DOTNET_EnableDiagnostics_Profiler

Vanaf .NET 8, wanneer deze is ingesteld 0, wordt profilering uitgeschakeld en kan deze niet worden overschreven door andere diagnostische instellingen. Standaard ingesteld op 1.

EventPipe-variabelen

Zie EventPipe-omgevingsvariabelen voor meer informatie.

  • DOTNET_EnableEventPipe: Wanneer deze optie is ingesteld 1, schakelt u tracering via EventPipe in.
  • DOTNET_EventPipeOutputPath: het uitvoerpad waar de tracering wordt geschreven.
  • DOTNET_EventPipeOutputStreaming: Wanneer deze optie is ingesteld 1, wordt streaming naar het uitvoerbestand ingeschakeld terwijl de app wordt uitgevoerd. Standaard worden traceringsgegevens verzameld in een kringbuffer en worden de inhoud geschreven bij het afsluiten van de app.

Omgevingsvariabelen voor .NET SDK en CLI

DOTNET_ROOT, , , DOTNET_ROOT(x86)DOTNET_ROOT_X86DOTNET_ROOT_X64

Hiermee geeft u de locatie van de .NET-runtimes op als ze niet zijn geïnstalleerd op de standaardlocatie. De standaardlocatie in Windows is C:\Program Files\dotnet. De standaardlocatie in macOS is /usr/local/share/dotnet. De standaardlocatie voor de x64-runtimes op een arm64-besturingssysteem bevindt zich onder een x64-submap (bijvoorbeeld C:\Program Files\dotnet\x64 windows en /usr/local/share/dotnet/x64 macOS). De standaardlocatie voor Linux is afhankelijk van de distributie- en installatiemethode. De standaardlocatie op Ubuntu 22.04 is /usr/share/dotnet (wanneer geïnstalleerd vanaf packages.microsoft.com) of /usr/lib/dotnet (wanneer geïnstalleerd vanuit Jammy-feed). Voor meer informatie raadpleegt u de volgende bronnen:

Deze omgevingsvariabele wordt alleen gebruikt bij het uitvoeren van apps via gegenereerde uitvoerbare bestanden (apphosts). DOTNET_ROOT(x86) wordt in plaats daarvan gebruikt bij het uitvoeren van een 32-bits uitvoerbaar bestand op een 64-bits besturingssysteem. DOTNET_ROOT_X64 wordt in plaats daarvan gebruikt bij het uitvoeren van een 64-bits uitvoerbaar bestand op een ARM64-besturingssysteem.

DOTNET_HOST_PATH

Hiermee geeft u het absolute pad naar een dotnet host (dotnet.exe in Windows, dotnet op Linux en macOS) die is gebruikt om het momenteel actieve dotnet proces te starten. Dit wordt gebruikt door de .NET SDK om hulpprogramma's te helpen die tijdens .NET SDK-opdrachten worden uitgevoerd, ervoor te zorgen dat ze dezelfde dotnet runtime gebruiken voor alle onderliggende dotnet processen die ze maken voor de duur van de opdracht. Hulpprogramma's en MSBuild Tasks binnen de SDK die binaire bestanden via de dotnet host aanroepen, moeten naar verwachting aan deze omgevingsvariabele worden voldaan om een consistente ervaring te garanderen.

Hulpprogramma's die worden aangeroepen dotnet tijdens een SDK-opdracht, moeten het volgende algoritme gebruiken om het te vinden:

  • als DOTNET_HOST_PATH deze is ingesteld, gebruikt u die waarde rechtstreeks
  • anders, vertrouwt u op dotnet via het systeem PATH

Notitie

DOTNET_HOST_PATH is geen algemene oplossing voor het vinden van de dotnet host. Het is alleen bedoeld om te worden gebruikt door hulpprogramma's die worden aangeroepen door de .NET SDK.

DOTNET_LAUNCH_PROFILE

Met de opdracht dotnet-uitvoering wordt deze variabele ingesteld op het geselecteerde startprofiel.

Gezien de volgende lancering Instellingen.json bestand:

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

En het volgende Program.cs bestand:

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

In de volgende scenario's wordt de weergegeven uitvoer geproduceerd:

  • Startprofiel opgegeven en bestaat

    $ dotnet run --launch-profile First
    DOTNET_LAUNCH_PROFILE=First
    
  • Startprofiel niet opgegeven, eerste geselecteerd

    $ dotnet run
    DOTNET_LAUNCH_PROFILE=First
    
  • Startprofiel opgegeven, maar bestaat niet

    $ 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=
    
  • Starten zonder profiel

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

NUGET_PACKAGES

De map met globale pakketten. Als dit niet is ingesteld, wordt deze standaard ingesteld ~/.nuget/packages op Unix of %userprofile%\.nuget\packages in Windows.

DOTNET_SERVICING

Hiermee geeft u de locatie op van de service-index die moet worden gebruikt door de gedeelde host bij het laden van de runtime.

Hiermee geeft u op of .NET-welkomst- en telemetrieberichten worden weergegeven tijdens de eerste uitvoering. Ingesteld om true deze berichten (waardentrue, 1of yes geaccepteerd) te dempen of zo in te false stellen dat ze (waarden0false, of no geaccepteerd) zijn toegestaan. Als dit niet is ingesteld, is de standaardwaarde false en worden de berichten weergegeven tijdens de eerste uitvoering. Deze vlag heeft geen invloed op telemetrie (zie DOTNET_CLI_TELEMETRY_OPTOUT voor afmelding voor het verzenden van telemetrie).

DOTNET_CLI_PERF_LOG

Hiermee geeft u op of prestatiegegevens over de huidige CLI-sessie worden vastgelegd. Ingeschakeld wanneer deze optie is ingesteld op 1, trueof yes. Deze optie is standaard uitgeschakeld.

DOTNET_GENERATE_ASPNET_CERTIFICATE

Hiermee geeft u op of een ASP.NET Core-certificaat moet worden gegenereerd. De standaardwaarde is true, maar dit kan worden overschreven door deze omgevingsvariabele in te stellen op 0, falseof no.

DOTNET_ADD_GLOBAL_TOOLS_TO_PATH

Hiermee geeft u op of globale hulpprogramma's moeten worden toegevoegd aan de PATH omgevingsvariabele. De standaardwaarde is true. Als u geen globale hulpprogramma's aan het pad wilt toevoegen, stelt u in op 0, falseof no.

DOTNET_CLI_TELEMETRY_OPTOUT

Hiermee geeft u op of gegevens over het gebruik van .NET-hulpprogramma's worden verzameld en verzonden naar Microsoft. Ingesteld op true opt-out van de telemetriefunctie (waardentrue1, of yes geaccepteerd). Anders moet false u zich aanmelden voor de telemetriefuncties (waarden false0of no geaccepteerd). Als dit niet is ingesteld, is de standaardwaarde false en is de telemetriefunctie actief.

DOTNET_SKIP_FIRST_TIME_EXPERIENCE

Als DOTNET_SKIP_FIRST_TIME_EXPERIENCE dit is ingesteld true, wordt het NuGetFallbackFolder niet uitgebreid naar schijf en wordt er een kortere welkomstbericht en telemetriemelding weergegeven.

Notitie

Deze omgevingsvariabele wordt niet meer ondersteund in .NET Core 3.0 en hoger. Als vervanging gebruiken DOTNET_NOLOGO .

DOTNET_MULTILEVEL_LOOKUP

Hiermee geeft u op of de .NET-runtime, het gedeelde framework of de SDK worden omgezet vanaf de globale locatie. Als dit niet is ingesteld, wordt deze standaard ingesteld op 1 (logisch true). Stel de waarde in op 0 (logisch false) om niet te worden omgezet vanaf de globale locatie en .NET-installaties te hebben. Zie SharedFX Lookup op meerdere niveaus voor meer informatie over opzoeken op meerdere niveaus.

Notitie

Deze omgevingsvariabele is alleen van toepassing op toepassingen die gericht zijn op .NET 6 en eerdere versies. Vanaf .NET 7 zoekt .NET alleen naar frameworks op één locatie. Zie Zoeken op meerdere niveaus is uitgeschakeld voor meer informatie.

DOTNET_ROLL_FORWARD

Bepaalt het gedrag van roll forward. Zie de --roll-forward optie voor de dotnet opdracht voor meer informatie.

DOTNET_ROLL_FORWARD_TO_PRERELEASE

Als deze optie is ingesteld op 1 (ingeschakeld), schakelt u rolling forward naar een voorlopige versie van een releaseversie in. Standaard (0 - uitgeschakeld), wanneer een releaseversie van .NET-runtime wordt aangevraagd, kan roll-forward alleen worden gebruikt voor geïnstalleerde releaseversies.

Zie de --roll-forward optie voor de dotnet opdracht voor meer informatie

DOTNET_ROLL_FORWARD_ON_NO_CANDIDATE_FX

Schakelt secundaire versie-roll forward uit, indien ingesteld op 0. Deze instelling wordt vervangen door .NET Core 3.0 door DOTNET_ROLL_FORWARD. In plaats daarvan moeten de nieuwe instellingen worden gebruikt.

DOTNET_CLI_FORCE_UTF8_ENCODING

Dwingt het gebruik van UTF-8-codering in de console af, zelfs voor oudere versies van Windows 10 die UTF-8 niet volledig ondersteunen. Zie SDK voor meer informatie geen consolecodering meer wijzigen wanneer u klaar bent.

DOTNET_CLI_UI_LANGUAGE

Hiermee stelt u de taal van de CLI-gebruikersinterface in met behulp van een landinstellingswaarde, zoals en-us. De ondersteunde waarden zijn hetzelfde als voor Visual Studio. Zie de sectie over het wijzigen van de installatietaal in de installatiedocumentatie van Visual Studio voor meer informatie. De .NET Resource Manager-regels zijn van toepassing, dus u hoeft geen exacte overeenkomst te kiezen. U kunt ook afstammelingen in de CultureInfo structuur kiezen. Als u deze fr-CAbijvoorbeeld instelt op, vindt en gebruikt de CLI de fr vertalingen. Als u deze instelt op een taal die niet wordt ondersteund, wordt de CLI teruggezet naar het Engels.

DOTNET_DISABLE_GUI_ERRORS

Voor gegenereerde uitvoerbare bestanden met gui- schakelt het pop-upvenster uit, dat normaal gesproken wordt weergegeven voor bepaalde klassen fouten. In deze gevallen wordt alleen naar stderr en afgesloten.

DOTNET_ADDITIONAL_DEPS

Komt overeen met de CLI-optie --additional-deps.

DOTNET_RUNTIME_ID

Hiermee wordt de gedetecteerde RID overschreven.

DOTNET_SHARED_STORE

Locatie van het 'gedeelde archief' waar de assembly-resolutie in sommige gevallen terugvalt.

DOTNET_STARTUP_HOOKS

Lijst met assembly's waaruit opstarthook wordt geladen en uitgevoerd.

DOTNET_BUNDLE_EXTRACT_BASE_DIR

Hiermee geeft u een map op waarnaar een toepassing met één bestand wordt geëxtraheerd voordat deze wordt uitgevoerd.

Zie uitvoerbare bestanden met één bestand voor meer informatie.

DOTNET_CLI_CONTEXT_*

  • DOTNET_CLI_CONTEXT_VERBOSE: Als u een uitgebreide context wilt inschakelen, stelt u deze in op true.
  • DOTNET_CLI_CONTEXT_ANSI_PASS_THRU: Als u een ANSI-passthrough wilt inschakelen, stelt u in op true.

DOTNET_CLI_WORKLOAD_UPDATE_NOTIFY_DISABLE

Hiermee schakelt u het downloaden van reclamemanifesten op de achtergrond uit voor workloads. De standaardwaarde is false : niet uitgeschakeld. Als deze optie is ingesteld true, is downloaden uitgeschakeld. Zie Reclamemanifesten voor meer informatie.

DOTNET_CLI_WORKLOAD_UPDATE_NOTIFY_INTERVAL_HOURS

Hiermee geeft u het minimum aantal uren tussen achtergronddownloads van advertentiemanifesten voor workloads. De standaardwaarde is 24, wat niet vaker dan één keer per dag is. Zie Reclamemanifesten voor meer informatie.

DOTNET_TOOLS_ALLOW_MANIFEST_IN_ROOT

Hiermee geeft u op of lokale .NET SDK-hulpprogramma's zoeken naar manifestbestanden van hulpprogramma's in de hoofdmap van Windows. De standaardwaarde is false.

COREHOST_TRACE

Bepaalt diagnostische tracering van de hostingonderdelen, zoals dotnet.exe, hostfxren hostpolicy.

  • COREHOST_TRACE=[0/1] - standaard is 0 - tracering uitgeschakeld. Indien ingesteld op 1, is diagnostische tracering ingeschakeld.

  • COREHOST_TRACEFILE=<file path> - heeft alleen een effect als tracering is ingeschakeld door instelling COREHOST_TRACE=1. Wanneer deze is ingesteld, wordt de traceringsinformatie naar het opgegeven bestand geschreven; anders wordt de traceringsinformatie naar stderrgeschreven.

  • COREHOST_TRACE_VERBOSITY=[1/2/3/4] - de standaardwaarde is 4. De instelling wordt alleen gebruikt wanneer tracering is ingeschakeld via COREHOST_TRACE=1.

    • 4 - alle traceringsinformatie wordt geschreven
    • 3 - alleen informatieve, waarschuwings- en foutberichten worden geschreven
    • 2 - alleen waarschuwings- en foutberichten worden geschreven
    • 1 - alleen foutberichten worden geschreven

De gebruikelijke manier om gedetailleerde traceringsinformatie over het opstarten van toepassingen op te halen, is door de toepassing in te stellen COREHOST_TRACE=1 enCOREHOST_TRACEFILE=host_trace.txt vervolgens uit te voeren. Er wordt een nieuw bestand host_trace.txt gemaakt in de huidige map met de gedetailleerde informatie.

SuppressNETCoreSdkPreviewMessage

Als deze optie is ingesteld true, wordt er door aanroepen dotnet geen waarschuwing weergegeven wanneer een preview-SDK wordt gebruikt.

MSBuild configureren in de .NET CLI

Als u MSBuild out-of-process wilt uitvoeren, stelt u de DOTNET_CLI_RUN_MSBUILD_OUTOFPROC omgevingsvariabele 1in op , trueof yes. MSBuild voert standaard in-proc uit. MsBuild afdwingen dat een langdurig proces voor het bouwen van projecten wordt gebruikt met een extern werkknooppunt, ingesteld DOTNET_CLI_USE_MSBUILDNOINPROCNODE op 1, trueof yes. Hiermee stelt u de MSBUILDNOINPROCNODE omgevingsvariabele 1in op , die msBuild Server V1 wordt genoemd, omdat het invoerproces het grootste deel van het werk doorstuurt.

DOTNET_MSBUILD_SDK_RESOLVER_*

Dit zijn onderdrukkingen die worden gebruikt om de opgeloste SDK-taken en -doelen af te dwingen van een bepaalde basismap en een bepaalde versie te rapporteren aan MSBuild, wat kan zijn als onbekend.null Een belangrijke use case hiervoor is het testen van SDK-taken en -doelen zonder ze te implementeren met behulp van de .NET Core SDK.

  • DOTNET_MSBUILD_SDK_RESOLVER_SDKS_DIR: overschrijft de .NET SDK-map.
  • DOTNET_MSBUILD_SDK_RESOLVER_SDKS_VER: overschrijft de .NET SDK-versie.
  • DOTNET_MSBUILD_SDK_RESOLVER_CLI_DIR: hiermee wordt het pad naar de dotnet.exe map overschreven.

DOTNET_NEW_PREFERRED_LANG

Hiermee configureert u de standaardprogrammeertaal voor de dotnet new opdracht wanneer de -lang|--language schakeloptie wordt weggelaten. De standaardwaarde is C#. Geldige waarden zijn C#, F#of VB. Zie dotnet new voor meer informatie.

dotnet watch Omgevingsvariabelen

Zie dotnet omgevingsvariabelen bekijken voor informatie over dotnet watch instellingen die beschikbaar zijn als omgevingsvariabelen.

Zie ook