Konfigurationsalternativ för körning för globalisering

Artikel
11/14/2023

Invariant läge

Avgör om en .NET Core-app körs i globaliseringsvariant läge utan åtkomst till kulturspecifika data och beteende.
Om du utelämnar den här inställningen körs appen med åtkomst till kulturella data. Detta motsvarar att ange värdet till false.
Mer information finns i .NET Core-globalisering ivariant läge.

	Inställningsnamn	Värden
runtimeconfig.json	`System.Globalization.Invariant`	`false` - tillgång till kulturella data `true` – kör i invariant läge
MSBuild-egenskap	`InvariantGlobalization`	`false` - tillgång till kulturella data `true` – kör i invariant läge
Miljövariabel	`DOTNET_SYSTEM_GLOBALIZATION_INVARIANT`	`0` - tillgång till kulturella data `1` – kör i invariant läge

Exempel

runtimeconfig.json-fil :

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

runtimeconfig.template.json-fil :

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

Projektfil:

<Project Sdk="Microsoft.NET.Sdk">

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

</Project>

Intervall för eraår

Avgör om intervallkontroller för kalendrar som stöder flera epoker är avslappnade eller om datum som flödar över en eras datumintervall genererar en ArgumentOutOfRangeException.
Om du utelämnar den här inställningen är intervallkontrollerna avslappnade. Detta motsvarar att ange värdet till false.
Mer information finns i Kalendrar, epoker och datumintervall: Avslappnade intervallkontroller.

	Inställningsnamn	Värden
runtimeconfig.json	`Switch.System.Globalization.EnforceJapaneseEraYearRanges`	`false` - avspänna intervallkontroller `true` – spill orsakar ett undantag
Miljövariabel	Saknas	Saknas

Den här konfigurationsinställningen har ingen specifik MSBuild-egenskap. Du kan dock lägga till ett RuntimeHostConfigurationOption MSBuild-objekt i stället. Använd inställningsnamnet runtimeconfig.json som värdet för attributet Include . Ett exempel finns i MSBuild-egenskaper.

Japansk datumparsing

Avgör om en sträng som innehåller antingen "1" eller "Gannen" som året parsar korrekt eller om endast "1" stöds.
Om du utelämnar den här inställningen parsas strängar som innehåller antingen "1" eller "Gannen" som året. Detta motsvarar att ange värdet till false.
Mer information finns i Representera datum i kalendrar med flera epoker.

	Inställningsnamn	Värden
runtimeconfig.json	`Switch.System.Globalization.EnforceLegacyJapaneseDateParsing`	`false` – "Gannen" eller "1" stöds `true` – endast "1" stöds
Miljövariabel	Saknas	Saknas

Japanskt årsformat

Avgör om det första året i en japansk kalendertid formateras som "Gannen" eller som ett tal.
Om du utelämnar den här inställningen formateras det första året som "Gannen". Detta motsvarar att ange värdet till false.
Mer information finns i Representera datum i kalendrar med flera epoker.

	Inställningsnamn	Värden
runtimeconfig.json	`Switch.System.Globalization.FormatJapaneseFirstYearAsANumber`	`false` - formatera som "Gannen" `true` - formatera som tal
Miljövariabel	Saknas	Saknas

NLS

Avgör om .NET använder NATIONAL Language Support (NLS) eller International Components for Unicode (ICU) globaliserings-API:er för Windows-appar. .NET 5 och senare versioner använder ICU-globaliserings-API:er som standard på Maj 2019-uppdatering för Windows 10 och senare versioner.
Om du utelämnar den här inställningen använder .NET ICU-globaliserings-API:er som standard. Detta motsvarar att ange värdet till false.
Mer information finns i Globaliserings-API:er använder ICU-bibliotek i Windows.

	Inställningsnamn	Värden	Introducerade
runtimeconfig.json	`System.Globalization.UseNls`	`false` – Använda API:er för ICU-globalisering `true` – Använda NLS-globaliserings-API:er	.NET 5
Miljövariabel	`DOTNET_SYSTEM_GLOBALIZATION_USENLS`	`false` – Använda API:er för ICU-globalisering `true` – Använda NLS-globaliserings-API:er	.NET 5

Fördefinierade kulturer

Konfigurerar om appar kan skapa andra kulturer än den invarianta kulturen när globaliserings-invariant-läget är aktiverat.
Om du utelämnar den här inställningen begränsar .NET skapandet av kulturer i globaliseringsläge. Detta motsvarar att ange värdet till true.
Mer information finns i Skapa kultur och skiftlägesmappning i globaliseringsvariant läge.

	Inställningsnamn	Värden	Introducerade
runtimeconfig.json	`System.Globalization.PredefinedCulturesOnly`	`true` – I globaliserings-invariant läge ska du inte tillåta skapande av någon kultur förutom den invarianta kulturen. `false` - Tillåt skapandet av vilken kultur som helst.	.NET 6
MSBuild-egenskap	`PredefinedCulturesOnly`	`true` – I globaliserings-invariant läge ska du inte tillåta skapande av någon kultur förutom den invarianta kulturen. `false` - Tillåt skapandet av vilken kultur som helst.	.NET 6
Miljövariabel	`DOTNET_SYSTEM_GLOBALIZATION_PREDEFINED_CULTURES_ONLY`	`true` – I globaliserings-invariant läge ska du inte tillåta skapande av någon kultur förutom den invarianta kulturen. `false` - Tillåt skapandet av vilken kultur som helst.	.NET 6

Dela via