Možnosti konfigurace modulu runtime pro globalizaci

Článek
11/14/2023

Invariantní režim

Určuje, zda aplikace .NET Core běží v režimu globalizace invariant bez přístupu k datům a chováním specifických pro jazykovou verzi.
Pokud toto nastavení vynecháte, aplikace se spustí s přístupem k kulturním datům. To je ekvivalentní nastavení hodnoty na false.
Další informace najdete v tématu invariantní režim globalizace .NET Core.

	Název nastavení	Hodnoty
runtimeconfig.json	`System.Globalization.Invariant`	`false` - přístup k kulturním datům `true` - spustit v invariantní režimu
Vlastnost MSBuild	`InvariantGlobalization`	`false` - přístup k kulturním datům `true` - spustit v invariantní režimu
Proměnná prostředí	`DOTNET_SYSTEM_GLOBALIZATION_INVARIANT`	`0` - přístup k kulturním datům `1` - spustit v invariantní režimu

Příklady

soubor runtimeconfig.json :

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

soubor runtimeconfig.template.json :

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

Soubor projektu:

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

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

</Project>

Rozsahy let období

Určuje, zda jsou kontroly rozsahů pro kalendáře, které podporují více období, uvolněny nebo zda kalendářní data, která přetékají rozsah dat éry, vyvolává ArgumentOutOfRangeException.
Pokud toto nastavení vynecháte, kontroly rozsahu jsou uvolněné. To je ekvivalentní nastavení hodnoty na false.
Další informace naleznete v tématu Kalendáře, éry a rozsahy kalendářních dat: Uvolněné kontroly rozsahu.

	Název nastavení	Hodnoty
runtimeconfig.json	`Switch.System.Globalization.EnforceJapaneseEraYearRanges`	`false` - uvolněné kontroly rozsahu `true` – přetečení způsobí výjimku.
Proměnná prostředí	–	N/A

Toto nastavení konfigurace nemá konkrétní vlastnost MSBuild. Místo toho však můžete přidat RuntimeHostConfigurationOption položku NÁSTROJE MSBuild. Jako hodnotu atributu Include použijte název nastavení runtimeconfig.json. Příklad naleznete v tématu MSBuild vlastnosti.

Analýza japonských dat

Určuje, zda řetězec, který obsahuje buď "1", nebo "Gannen" jako rok parsuje úspěšně nebo zda je podporováno pouze "1".
Pokud toto nastavení vynecháte, řetězce, které obsahují hodnotu "1" nebo "Gannen" jako rok se úspěšně parsuje. To je ekvivalentní nastavení hodnoty na false.
Další informace naleznete v tématu Reprezentace kalendářních dat v kalendářích s více obdobími.

	Název nastavení	Hodnoty
runtimeconfig.json	`Switch.System.Globalization.EnforceLegacyJapaneseDateParsing`	`false` - Podporuje se "Gannen" nebo "1". `true` - Podporuje se jenom "1".
Proměnná prostředí	–	N/A

Japonský formát roku

Určuje, zda je první rok japonské éry kalendáře formátován jako "Gannen" nebo jako číslo.
Pokud toto nastavení vynecháte, první rok se naformátuje jako Gannen. To je ekvivalentní nastavení hodnoty na false.
Další informace naleznete v tématu Reprezentace kalendářních dat v kalendářích s více obdobími.

	Název nastavení	Hodnoty
runtimeconfig.json	`Switch.System.Globalization.FormatJapaneseFirstYearAsANumber`	`false` - formát jako "Gannen" `true` - formátovat jako číslo
Proměnná prostředí	–	N/A

NLS

Určuje, jestli .NET používá rozhraní API pro globalizaci pro kódování Unicode (ICU) národní jazykovou podporu (NLS) nebo mezinárodní komponenty pro aplikace pro Windows. Rozhraní .NET 5 a novější verze používají rozhraní API pro globalizaci ICU ve výchozím nastavení na Aktualizace Windows 10 z května 2019 a novějších verzích.
Pokud toto nastavení vynecháte, rozhraní .NET ve výchozím nastavení používá rozhraní API globalizace ICU. To je ekvivalentní nastavení hodnoty na false.
Další informace naleznete v tématu Globalization APIs use ICU libraries on Windows.

	Název nastavení	Hodnoty	Představení
runtimeconfig.json	`System.Globalization.UseNls`	`false` – Použití rozhraní API pro globalizaci ICU `true` – Použití rozhraní API globalizace NLS	.NET 5
Proměnná prostředí	`DOTNET_SYSTEM_GLOBALIZATION_USENLS`	`false` – Použití rozhraní API pro globalizaci ICU `true` – Použití rozhraní API globalizace NLS	.NET 5

Předdefinované jazykové verze

Konfiguruje, jestli aplikace můžou vytvářet jiné jazykové verze než invariantní jazykovou verzi, když je povolen režim globalizace invariant .
Pokud toto nastavení vynecháte, rozhraní .NET omezí vytváření jazykových verzí v režimu globalizace invariantní. To je ekvivalentní nastavení hodnoty na true.
Další informace naleznete v tématu Vytvoření jazykové verze a mapování případů v režimu globalizace invariant.

	Název nastavení	Hodnoty	Představení
runtimeconfig.json	`System.Globalization.PredefinedCulturesOnly`	`true` - V globalizačním režimu nepovolujte vytváření žádné jazykové verze s výjimkou invariantní jazykové verze. `false` - Povolte vytváření jakékoli kultury.	.NET 6
Vlastnost MSBuild	`PredefinedCulturesOnly`	`true` - V globalizačním režimu nepovolujte vytváření žádné jazykové verze s výjimkou invariantní jazykové verze. `false` - Povolte vytváření jakékoli kultury.	.NET 6
Proměnná prostředí	`DOTNET_SYSTEM_GLOBALIZATION_PREDEFINED_CULTURES_ONLY`	`true` - V globalizačním režimu nepovolujte vytváření žádné jazykové verze s výjimkou invariantní jazykové verze. `false` - Povolte vytváření jakékoli kultury.	.NET 6