Options de configuration du runtime pour la globalisation

Mode invariant

Détermine si une application .NET Core s’exécute en mode invariant de globalisation sans accès aux données et au comportement propres à la culture.
Si vous omettez ce paramètre, l’application s’exécute avec accès aux données culturelles. Cela revient à définir la valeur sur false.
Pour plus d’informations, consultez Le mode invariant de globalisation .NET Core.

	Nom du paramètre	Valeurs
runtimeconfig.json	`System.Globalization.Invariant`	`false` - accès aux données culturelles `true` - exécution en mode invariant
Propriété MSBuild	`InvariantGlobalization`	`false` - accès aux données culturelles `true` - exécution en mode invariant
Variable d'environnement	`DOTNET_SYSTEM_GLOBALIZATION_INVARIANT`	`0` - accès aux données culturelles `1` - exécution en mode invariant

fichier runtimeconfig.json :

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

Fichier projet :

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

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

</Project>

Détermine si les vérifications de plage pour les calendriers qui prennent en charge plusieurs ères sont assouplies ou si les dates qui dépassent la plage de dates d’une ère lèvent un ArgumentOutOfRangeException.
Si vous omettez ce paramètre, les vérifications de plage sont assouplies. Cela revient à définir la valeur sur false.
Pour plus d’informations, consultez Calendriers, ères et plages de dates : vérifications de plage détendues.

	Nom du paramètre	Valeurs
runtimeconfig.json	`Switch.System.Globalization.EnforceJapaneseEraYearRanges`	`false` - contrôles de plage assouplis `true` - Les dépassements de capacité provoquent une exception
Variable d'environnement	N/A	N/A

Détermine si une chaîne qui contient « 1 » ou « Gannen » pendant l’analyse de l’année avec succès ou si seul « 1 » est pris en charge.
Si vous omettez ce paramètre, les chaînes qui contiennent « 1 » ou « Gannen » comme année s’analysent correctement. Cela revient à définir la valeur sur false.
Pour plus d’informations, consultez Représenter des dates dans des calendriers avec plusieurs ères.

	Nom du paramètre	Valeurs
runtimeconfig.json	`Switch.System.Globalization.EnforceLegacyJapaneseDateParsing`	`false` - « Gannen » ou « 1 » est pris en charge `true` - seul « 1 » est pris en charge
Variable d'environnement	N/A	N/A

Détermine si la première année d’une ère de calendrier japonais est mise en forme en tant que « Gannen » ou en tant que nombre.
Si vous omettez ce paramètre, la première année est au format « Gannen ». Cela revient à définir la valeur sur false.
Pour plus d’informations, consultez Représenter des dates dans des calendriers avec plusieurs ères.

	Nom du paramètre	Valeurs
runtimeconfig.json	`Switch.System.Globalization.FormatJapaneseFirstYearAsANumber`	`false` - format « Gannen » `true` - format en tant que nombre
Variable d'environnement	N/A	N/A

Détermine si .NET utilise les API de globalisation NLS (National Language Support) ou International Components for Unicode (ICU) pour les applications Windows. .NET 5 et versions ultérieures utilisent les API de globalisation des ICU par défaut sur Mise à jour de mai 2019 de Windows 10 et versions ultérieures.
Si vous omettez ce paramètre, .NET utilise les API de globalisation des ICU par défaut. Cela revient à définir la valeur sur false.
Pour plus d’informations, consultez Les API de globalisation utilisent des bibliothèques ICU sur Windows.

	Nom du paramètre	Valeurs	Introduit
runtimeconfig.json	`System.Globalization.UseNls`	`false` - Utiliser les API de globalisation des ICU `true` - Utiliser les API de globalisation NLS	.NET 5
Variable d'environnement	`DOTNET_SYSTEM_GLOBALIZATION_USENLS`	`false` - Utiliser les API de globalisation des ICU `true` - Utiliser les API de globalisation NLS	.NET 5

Configure si les applications peuvent créer des cultures autres que la culture indifférente lorsque le mode invariant de globalisation est activé.
Si vous omettez ce paramètre, .NET limite la création de cultures en mode invariant de globalisation. Cela revient à définir la valeur sur true.
Pour plus d’informations, consultez Création de culture et mappage de cas en mode invariant de globalisation.

	Nom du paramètre	Valeurs	Introduit
runtimeconfig.json	`System.Globalization.PredefinedCulturesOnly`	`true` - En mode invariant de globalisation, n’autorisez pas la création d’une culture à l’exception de la culture indifférente. `false` - Autoriser la création de n’importe quelle culture.	.NET 6
Propriété MSBuild	`PredefinedCulturesOnly`	`true` - En mode invariant de globalisation, n’autorisez pas la création d’une culture à l’exception de la culture indifférente. `false` - Autoriser la création de n’importe quelle culture.	.NET 6
Variable d'environnement	`DOTNET_SYSTEM_GLOBALIZATION_PREDEFINED_CULTURES_ONLY`	`true` - En mode invariant de globalisation, n’autorisez pas la création d’une culture à l’exception de la culture indifférente. `false` - Autoriser la création de n’importe quelle culture.	.NET 6