Параметры конфигурации времени выполнения для глобализацииRun-time configuration options for globalization

Invariant mode (Инвариантный режим)Invariant mode

  • Определяет, выполняется ли приложение .NET Core в инвариантном режиме глобализации без доступа к данным и поведению, зависящим от языка и региональных параметров.Determines whether a .NET Core app runs in globalization-invariant mode without access to culture-specific data and behavior.
  • Если этот параметр не задан, приложение будет работать с доступом к данным языка и региональных параметров.If you omit this setting, the app runs with access to cultural data. Это эквивалентно присвоению значения false.This is equivalent to setting the value to false.
  • Дополнительные сведения см. в статье Инвариантный режим глобализации .NET Core.For more information, see .NET Core globalization invariant mode.
Имя параметраSetting name ЗначенияValues
runtimeconfig.jsonruntimeconfig.json System.Globalization.Invariant false — доступ к данным языка и региональных параметровfalse - access to cultural data
true — выполнение в инвариантном режимеtrue - run in invariant mode
Свойство MSBuildMSBuild property InvariantGlobalization false — доступ к данным языка и региональных параметровfalse - access to cultural data
true — выполнение в инвариантном режимеtrue - run in invariant mode
Переменная средыEnvironment variable DOTNET_SYSTEM_GLOBALIZATION_INVARIANT 0 — доступ к данным языка и региональных параметров0 - access to cultural data
1 — выполнение в инвариантном режиме1 - run in invariant mode

ПримерыExamples

Файл runtimeconfig.jsonruntimeconfig.json file:

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

Файл проекта:Project file:

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

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

</Project>

Era year ranges (Диапазоны лет эры)Era year ranges

Имя параметраSetting name ЗначенияValues
runtimeconfig.jsonruntimeconfig.json Switch.System.Globalization.EnforceJapaneseEraYearRanges false — нестрогие проверки диапазоновfalse - relaxed range checks
true — исключение при переполненииtrue - overflows cause an exception
Переменная средыEnvironment variable Н/ДN/A Н/ДN/A

Japanese date parsing (Анализ дат на японском языке)Japanese date parsing

  • Определяет, успешно ли анализируется строка, содержащая "1" или "Ганнен" в качестве года, либо поддерживается только значение "1".Determines whether a string that contains either "1" or "Gannen" as the year parses successfully or whether only "1" is supported.
  • Если этот параметр не задан, строки, содержащие "1" или "Ганнен" в качестве года, будут успешно проанализированы.If you omit this setting, strings that contain either "1" or "Gannen" as the year parse successfully. Это эквивалентно присвоению значения false.This is equivalent to setting the value to false.
  • Дополнительные сведения см. в разделе Представление дат в календарях с несколькими эрами.For more information, see Represent dates in calendars with multiple eras.
Имя параметраSetting name ЗначенияValues
runtimeconfig.jsonruntimeconfig.json Switch.System.Globalization.EnforceLegacyJapaneseDateParsing false — поддерживается "Ганнен" или "1"false - "Gannen" or "1" is supported
true — поддерживается только "1"true - only "1" is supported
Переменная средыEnvironment variable Н/ДN/A Н/ДN/A

Japanese year format (Японский формат года)Japanese year format

  • Определяет, форматируется ли первый год японской календарной эры как "Ганнен" или как число.Determines whether the first year of a Japanese calendar era is formatted as "Gannen" or as a number.
  • Если этот параметр не задан, первый год форматируется, как "Ганнен".If you omit this setting, the first year is formatted as "Gannen". Это эквивалентно присвоению значения false.This is equivalent to setting the value to false.
  • Дополнительные сведения см. в разделе Представление дат в календарях с несколькими эрами.For more information, see Represent dates in calendars with multiple eras.
Имя параметраSetting name ЗначенияValues
runtimeconfig.jsonruntimeconfig.json Switch.System.Globalization.FormatJapaneseFirstYearAsANumber false — формат в виде "Ганнен"false - format as "Gannen"
true — формат в виде числаtrue - format as number
Переменная средыEnvironment variable Н/ДN/A Н/ДN/A

NLSNLS

  • Определяет, использует ли .NET API глобализации для приложений Windows: National Language Support (NLS) и International Components for Unicode (ICU).Determines whether .NET uses National Language Support (NLS) or International Components for Unicode (ICU) globalization APIs for Windows apps. .NET 5.0 и более поздних версий использует API глобализации ICU по умолчанию в обновлении Windows за 10 мая 2019 г. и более поздних версиях..NET 5.0 and later versions use ICU globalization APIs by default on Windows 10 May 2019 Update and later versions.
  • Если этот параметр не задан, .NET по умолчанию использует API глобализации ICU.If you omit this setting, .NET uses ICU globalization APIs by default. Это эквивалентно присвоению значения false.This is equivalent to setting the value to false.
  • См. сведения об API глобализации, которые используют библиотеки ICU в Windows.For more information, see Globalization APIs use ICU libraries on Windows.
Имя параметраSetting name ЗначенияValues ВведенныйIntroduced
runtimeconfig.jsonruntimeconfig.json System.Globalization.UseNls false — использование API глобализации ICUfalse - Use ICU globalization APIs
true — использование API глобализации NLStrue - Use NLS globalization APIs
.NET 5.0.NET 5.0
Переменная средыEnvironment variable DOTNET_SYSTEM_GLOBALIZATION_USENLS false — использование API глобализации ICUfalse - Use ICU globalization APIs
true — использование API глобализации NLStrue - Use NLS globalization APIs
.NET 5.0.NET 5.0