Sdílet prostřednictvím

Možnosti konfigurace modulu runtime pro globalizaci

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 položky 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

Examples

runtimeconfig.json soubor:

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

runtimeconfig.template.json soubor:

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

Soubor projektu:

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

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

</Project>

Rozsahy let období

Název položky 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 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 použijte název nastavení runtimeconfig.json.Include 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 položky 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 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 použijte název nastavení runtimeconfig.json.Include Příklad naleznete v tématu MSBuild vlastnosti.

Japonský formát roku

Název položky nastavení Hodnoty
runtimeconfig.json Switch.System.Globalization.FormatJapaneseFirstYearAsANumber false - formát jako "Gannen"
true - formátovat jako číslo
Proměnná prostředí N/A 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 použijte název nastavení runtimeconfig.json.Include Příklad naleznete v tématu MSBuild vlastnosti.

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í ve Windows 10. května 2019 Update 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 položky 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

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 použijte název nastavení runtimeconfig.json.Include Příklad naleznete v tématu MSBuild vlastnosti.

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 položky 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
  • Last updated on