Opcje konfiguracji środowiska uruchomieniowego dla globalizacji

Artykuł
11/14/2023

Niezmienny tryb

Określa, czy aplikacja .NET Core działa w trybie niezmiennym globalizacji bez dostępu do danych i zachowań specyficznych dla kultury.
Jeśli to ustawienie zostanie pominięte, aplikacja będzie działać z dostępem do danych kulturowych. Jest to równoważne ustawieniu wartości na false.
Aby uzyskać więcej informacji, zobacz Tryb niezmienny globalizacji platformy .NET Core.

	Nazwa ustawienia	Wartości
runtimeconfig.json	`System.Globalization.Invariant`	`false` - dostęp do danych kulturowych `true` - uruchamianie w trybie niezmiennym
Właściwość MSBuild	`InvariantGlobalization`	`false` - dostęp do danych kulturowych `true` - uruchamianie w trybie niezmiennym
Zmienna środowiskowa	`DOTNET_SYSTEM_GLOBALIZATION_INVARIANT`	`0` - dostęp do danych kulturowych `1` - uruchamianie w trybie niezmiennym

Przykłady

Plik runtimeconfig.json :

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

plik runtimeconfig.template.json :

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

Plik projektu:

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

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

</Project>

Zakresy lat ery

Określa, czy sprawdzanie zakresu kalendarzy obsługujących wiele epok jest złagodzone, czy też daty, które przepełniają zakres dat epoki, zgłaszają wartość ArgumentOutOfRangeException.
Jeśli to ustawienie zostanie pominięte, kontrole zakresu zostaną złagodzone. Jest to równoważne ustawieniu wartości na false.
Aby uzyskać więcej informacji, zobacz Kalendarze, era i zakresy dat: Luźne kontrole zakresu.

	Nazwa ustawienia	Wartości
runtimeconfig.json	`Switch.System.Globalization.EnforceJapaneseEraYearRanges`	`false` - zrelaksowane kontrole zakresów `true` - przepełnienie powoduje wyjątek
Zmienna środowiskowa	Brak	Brak

To ustawienie konfiguracji nie ma określonej właściwości MSBuild. Można jednak dodać RuntimeHostConfigurationOption element MSBuild. Użyj nazwy ustawienia runtimeconfig.json jako wartości atrybutuInclude. Aby zapoznać się z przykładem, zobacz Właściwości programu MSBuild.

Analizowanie dat japońskich

Określa, czy ciąg zawierający ciąg "1" lub "Gannen" jako rok analizuje się pomyślnie, czy tylko "1" jest obsługiwany.
Jeśli pominiesz to ustawienie, ciągi zawierające ciągi "1" lub "Gannen" jako rok będą analizować pomyślnie. Jest to równoważne ustawieniu wartości na false.
Aby uzyskać więcej informacji, zobacz Reprezentacja dat w kalendarzach z wieloma epokami.

	Nazwa ustawienia	Wartości
runtimeconfig.json	`Switch.System.Globalization.EnforceLegacyJapaneseDateParsing`	`false` - Obsługiwane są "Gannen" lub "1" `true` — obsługiwane jest tylko "1"
Zmienna środowiskowa	Brak	Brak

Format roku japońskiego

Określa, czy pierwszy rok ery kalendarza japońskiego jest sformatowany jako "Gannen", czy jako liczba.
Jeśli to ustawienie zostanie pominięte, pierwszy rok zostanie sformatowany jako "Gannen". Jest to równoważne ustawieniu wartości na false.
Aby uzyskać więcej informacji, zobacz Reprezentacja dat w kalendarzach z wieloma epokami.

	Nazwa ustawienia	Wartości
runtimeconfig.json	`Switch.System.Globalization.FormatJapaneseFirstYearAsANumber`	`false` - format jako "Gannen" `true` - formatuj jako liczbę
Zmienna środowiskowa	Brak	Brak

NLS

Określa, czy platforma .NET używa interfejsów API globalizacji międzynarodowych (NLS) lub międzynarodowych składników dla interfejsów API globalizacji Unicode (ICU) dla aplikacji systemu Windows. Platforma .NET 5 i nowsze wersje domyślnie używają interfejsów API globalizacji ICU w Aktualizacja systemu Windows 10 z maja 2019 i nowszych wersjach.
Jeśli to ustawienie zostanie pominięte, platforma .NET domyślnie używa interfejsów API globalizacji ICU. Jest to równoważne ustawieniu wartości na false.
Aby uzyskać więcej informacji, zobacz Interfejsy API globalizacji używają bibliotek ICU w systemie Windows.

	Nazwa ustawienia	Wartości	Wprowadzono
runtimeconfig.json	`System.Globalization.UseNls`	`false` — Korzystanie z interfejsów API globalizacji ICU `true` — Korzystanie z interfejsów API globalizacji NLS	.NET 5
Zmienna środowiskowa	`DOTNET_SYSTEM_GLOBALIZATION_USENLS`	`false` — Korzystanie z interfejsów API globalizacji ICU `true` — Korzystanie z interfejsów API globalizacji NLS	.NET 5

Wstępnie zdefiniowane kultury

Określa, czy aplikacje mogą tworzyć kultury inne niż niezmienna kultura, gdy jest włączony tryb niezmienny globalizacji.
Jeśli to ustawienie zostanie pominięte, platforma .NET ogranicza tworzenie kultur w trybie niezmiennym globalizacji. Jest to równoważne ustawieniu wartości na true.
Aby uzyskać więcej informacji, zobacz Tworzenie kultury i mapowanie wielkości liter w trybie niezmiennym globalizacji.

	Nazwa ustawienia	Wartości	Wprowadzono
runtimeconfig.json	`System.Globalization.PredefinedCulturesOnly`	`true` - W trybie niezmiennym globalizacji nie zezwalaj na tworzenie żadnej kultury, z wyjątkiem niezmiennej kultury. `false` - Zezwalaj na tworzenie dowolnej kultury.	.NET 6
Właściwość MSBuild	`PredefinedCulturesOnly`	`true` - W trybie niezmiennym globalizacji nie zezwalaj na tworzenie żadnej kultury, z wyjątkiem niezmiennej kultury. `false` - Zezwalaj na tworzenie dowolnej kultury.	.NET 6
Zmienna środowiskowa	`DOTNET_SYSTEM_GLOBALIZATION_PREDEFINED_CULTURES_ONLY`	`true` - W trybie niezmiennym globalizacji nie zezwalaj na tworzenie żadnej kultury, z wyjątkiem niezmiennej kultury. `false` - Zezwalaj na tworzenie dowolnej kultury.	.NET 6