Futtatókörnyezet konfigurációs beállításai a globalizációhoz

Cikk
11/14/2023

Invariáns mód

Meghatározza, hogy a .NET Core-alkalmazások globalizációs invariáns módban futnak-e a kultúraspecifikus adatokhoz és viselkedéshez való hozzáférés nélkül.
Ha kihagyja ezt a beállítást, az alkalmazás kulturális adatokhoz való hozzáféréssel fut. Ez egyenértékű az érték falsebeállításával.
További információ: .NET Core globalization invariant mode.

	A beállítás neve	Értékek
runtimeconfig.json	`System.Globalization.Invariant`	`false` - kulturális adatokhoz való hozzáférés `true` - invariáns módban fut
MSBuild tulajdonság	`InvariantGlobalization`	`false` - kulturális adatokhoz való hozzáférés `true` - invariáns módban fut
Környezeti változó	`DOTNET_SYSTEM_GLOBALIZATION_INVARIANT`	`0` - kulturális adatokhoz való hozzáférés `1` - invariáns módban fut

Példák

runtimeconfig.json fájl:

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

runtimeconfig.template.json fájl:

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

Projektfájl:

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

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

</Project>

Era year ranges

Azt határozza meg, hogy a több korszakot támogató naptárak tartomány-ellenőrzései lazulnak-e, vagy hogy az adott kor dátumtartományát túlcsorduló dátumok adnak-e ArgumentOutOfRangeException.
Ha kihagyja ezt a beállítást, a tartományellenőrzések enyhülnek. Ez egyenértékű az érték falsebeállításával.
További információ: Naptárak, korszakok és dátumtartományok: Nyugodt tartományellenőrzések.

	A beállítás neve	Értékek
runtimeconfig.json	`Switch.System.Globalization.EnforceJapaneseEraYearRanges`	`false` - nyugodt tartományellenőrzések `true` - a túlcsordulások kivételt okoznak
Környezeti változó	N.A.	N.A.

Ez a konfigurációs beállítás nem tartalmaz adott MSBuild tulajdonságot. Ehelyett azonban hozzáadhat egy RuntimeHostConfigurationOption MSBuild elemet. Használja a runtimeconfig.json beállításnevet az Include attribútum értékeként. Példa: MSBuild properties.

Japán dátumelemzés

Azt határozza meg, hogy az "1" vagy a "Gannen" értéket tartalmazó sztring sikeresen elemzi-e az évet, vagy csak az "1" támogatott-e.
Ha kihagyja ezt a beállítást, az "1" vagy a "Gannen" értéket tartalmazó sztringek sikeresen elemzik az évet. Ez egyenértékű az érték falsebeállításával.
További információ: Dátumok ábrázolása több korszakot tartalmazó naptárakban.

	A beállítás neve	Értékek
runtimeconfig.json	`Switch.System.Globalization.EnforceLegacyJapaneseDateParsing`	`false` - "Gannen" vagy "1" támogatott `true` - csak az "1" támogatott
Környezeti változó	N.A.	N.A.

Japán év formátuma

Meghatározza, hogy egy japán naptárkorszak első éve "Gannen" vagy számként van-e formázva.
Ha kihagyja ezt a beállítást, az első év "Gannen" formátumban lesz formázva. Ez egyenértékű az érték falsebeállításával.
További információ: Dátumok ábrázolása több korszakot tartalmazó naptárakban.

	A beállítás neve	Értékek
runtimeconfig.json	`Switch.System.Globalization.FormatJapaneseFirstYearAsANumber`	`false` - formátum "Gannen" `true` - formátum számként
Környezeti változó	N.A.	N.A.

NLS

Meghatározza, hogy a .NET nemzeti nyelvi támogatást (NLS) vagy Nemzetközi összetevőket használ-e a Unicode (ICU) globalizálási API-jaihoz Windows-alkalmazásokhoz. A .NET 5-ös és újabb verziói alapértelmezés szerint ICU globalizálási API-kat használnak Windows 10 2019. májusi frissítése és újabb verziókon.
Ha kihagyja ezt a beállítást, a .NET alapértelmezés szerint ICU globalizációs API-kat használ. Ez egyenértékű az érték falsebeállításával.
További információ: Globalization API-k ICU-kódtárakat használnak Windows rendszeren.

	A beállítás neve	Értékek	Bevezetett
runtimeconfig.json	`System.Globalization.UseNls`	`false` - ICU globalizációs API-k használata `true` - NLS globalizációs API-k használata	.NET 5
Környezeti változó	`DOTNET_SYSTEM_GLOBALIZATION_USENLS`	`false` - ICU globalizációs API-k használata `true` - NLS globalizációs API-k használata	.NET 5

Előre definiált kultúrák

Konfigurálja, hogy az alkalmazások a globalizációs invariáns mód engedélyezésekor az invariáns kultúrától eltérő kultúrákat is létrehozhatnak-e.
Ha kihagyja ezt a beállítást, a .NET korlátozza a kultúrák létrehozását globalizációs invariáns módban. Ez egyenértékű az érték truebeállításával.
További információ: Kultúra létrehozása és esetleképezés globalizációs invariáns módban.

	A beállítás neve	Értékek	Bevezetett
runtimeconfig.json	`System.Globalization.PredefinedCulturesOnly`	`true` - Globalizációs invariáns módban az invariáns kultúra kivételével ne engedélyezze a kultúra létrehozását. `false` - Bármely kultúra létrehozásának engedélyezése.	.NET 6
MSBuild tulajdonság	`PredefinedCulturesOnly`	`true` - Globalizációs invariáns módban az invariáns kultúra kivételével ne engedélyezze a kultúra létrehozását. `false` - Bármely kultúra létrehozásának engedélyezése.	.NET 6
Környezeti változó	`DOTNET_SYSTEM_GLOBALIZATION_PREDEFINED_CULTURES_ONLY`	`true` - Globalizációs invariáns módban az invariáns kultúra kivételével ne engedélyezze a kultúra létrehozását. `false` - Bármely kultúra létrehozásának engedélyezése.	.NET 6