Runtimeconfiguratieopties voor globalisatie

Artikel
11/14/2023

Invariantmodus

Bepaalt of een .NET Core-app wordt uitgevoerd in de globalization-invariant-modus zonder toegang tot cultuurspecifieke gegevens en gedrag.
Als u deze instelling weglaat, wordt de app uitgevoerd met toegang tot culturele gegevens. Dit komt overeen met het instellen van de waarde op false.
Zie de invariante .NET Core-globalisatiemodus voor meer informatie.

	Naam instelling	Waarden
runtimeconfig.json	`System.Globalization.Invariant`	`false` - toegang tot culturele gegevens `true` - invariantmodus uitvoeren
MSBuild-eigenschap	`InvariantGlobalization`	`false` - toegang tot culturele gegevens `true` - invariantmodus uitvoeren
Omgevingsvariabele	`DOTNET_SYSTEM_GLOBALIZATION_INVARIANT`	`0` - toegang tot culturele gegevens `1` - invariantmodus uitvoeren

Voorbeelden

runtimeconfig.json-bestand :

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

runtimeconfig.template.json-bestand :

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

Projectbestand:

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

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

</Project>

Jaarbereiken era

Bepaalt of het bereik controleert op kalenders die meerdere tijdperken ondersteunen, ontspannen zijn of dat datums die het datumbereik van een tijdperk overlopen, een ArgumentOutOfRangeException.
Als u deze instelling weglaat, worden bereikcontroles versoepeld. Dit komt overeen met het instellen van de waarde op false.
Zie Agenda's, tijdperken en datumbereiken voor meer informatie : Controles van ontspannen bereiken.

	Naam instelling	Waarden
runtimeconfig.json	`Switch.System.Globalization.EnforceJapaneseEraYearRanges`	`false` - ontspannen bereikcontroles `true` - overloop veroorzaakt een uitzondering
Omgevingsvariabele	N.v.t.	N.v.t.

Deze configuratie-instelling heeft geen specifieke MSBuild-eigenschap. U kunt echter in plaats daarvan een RuntimeHostConfigurationOption MSBuild-item toevoegen. Gebruik de naam van de instelling runtimeconfig.json als de waarde van het Include kenmerk. Zie MSBuild-eigenschappen voor een voorbeeld.

Japanse datumparsering

Bepaalt of een tekenreeks met '1' of 'Gannen' als het jaar wordt geparseerd of alleen '1' wordt ondersteund.
Als u deze instelling weglaat, worden tekenreeksen met '1' of 'Gannen' als het jaar geparseerd. Dit komt overeen met het instellen van de waarde op false.
Zie Datums weergeven in kalenders met meerdere tijdperken voor meer informatie.

	Naam instelling	Waarden
runtimeconfig.json	`Switch.System.Globalization.EnforceLegacyJapaneseDateParsing`	`false` - "Gannen" of "1" wordt ondersteund `true` - alleen '1' wordt ondersteund
Omgevingsvariabele	N.v.t.	N.v.t.

Japanse jaarnotatie

Bepaalt of het eerste jaar van een Japans kalendertijdperk is opgemaakt als 'Gannen' of als een getal.
Als u deze instelling weglaat, wordt het eerste jaar opgemaakt als 'Gannen'. Dit komt overeen met het instellen van de waarde op false.
Zie Datums weergeven in kalenders met meerdere tijdperken voor meer informatie.

	Naam instelling	Waarden
runtimeconfig.json	`Switch.System.Globalization.FormatJapaneseFirstYearAsANumber`	`false` - formatteren als "Gannen" `true` - notatie als getal
Omgevingsvariabele	N.v.t.	N.v.t.

NLS

Bepaalt of .NET gebruikmaakt van National Language Support (NLS) of International Components for Unicode (ICU) globalization API's voor Windows-apps. .NET 5 en latere versies maken standaard gebruik van ICU-globalisatie-API's in Windows 10 mei 2019 Update en latere versies.
Als u deze instelling weglaat, gebruikt .NET standaard ICU-globalisatie-API's. Dit komt overeen met het instellen van de waarde op false.
Zie Globalization-API's voor meer informatie over ICU-bibliotheken in Windows.

	Naam instelling	Waarden	Geïntroduceerd
runtimeconfig.json	`System.Globalization.UseNls`	`false` - ICU-globalisatie-API's gebruiken `true` - NLS Globalization-API's gebruiken	.NET 5
Omgevingsvariabele	`DOTNET_SYSTEM_GLOBALIZATION_USENLS`	`false` - ICU-globalisatie-API's gebruiken `true` - NLS Globalization-API's gebruiken	.NET 5

Vooraf gedefinieerde culturen

Hiermee configureert u of apps andere culturen kunnen maken dan de invariante cultuur wanneer de globalisatie-invariantmodus is ingeschakeld.
Als u deze instelling weglaat, beperkt .NET het maken van culturen in de modus globalization-invariant. Dit komt overeen met het instellen van de waarde op true.
Zie Culture creation and case mapping in globalization-invariant mode voor meer informatie.

	Naam instelling	Waarden	Geïntroduceerd
runtimeconfig.json	`System.Globalization.PredefinedCulturesOnly`	`true` - In de globalization-invariant-modus staat u het maken van geen enkele cultuur toe, behalve de invariante cultuur. `false` - Het creëren van een cultuur toestaan.	.NET 6
MSBuild-eigenschap	`PredefinedCulturesOnly`	`true` - In de globalization-invariant-modus staat u het maken van geen enkele cultuur toe, behalve de invariante cultuur. `false` - Het creëren van een cultuur toestaan.	.NET 6
Omgevingsvariabele	`DOTNET_SYSTEM_GLOBALIZATION_PREDEFINED_CULTURES_ONLY`	`true` - In de globalization-invariant-modus staat u het maken van geen enkele cultuur toe, behalve de invariante cultuur. `false` - Het creëren van een cultuur toestaan.	.NET 6