Options de configuration du runtime pour la globalisation

Article
11/22/2023

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 un accès aux données culturelles. Ceci équivaut à définir la valeur false.
Pour plus d’informations, consultez 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

Exemples

Fichier runtimeconfig.json :

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

Fichier runtimeconfig.template.json :

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

Fichier projet :

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

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

</Project>

Plages d’années d’ère

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 une exception ArgumentOutOfRangeException.
Si vous omettez ce paramètre, les vérifications de plage sont assouplies. Ceci équivaut à définir la valeur false.
Pour plus d’informations, consultez Calendriers, ères et plages de dates : vérifications de plage assouplies.

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

Ce paramètre de configuration n'a pas de propriété MSBuild spécifique. Toutefois, vous pouvez ajouter un élément MSBuild RuntimeHostConfigurationOption à la place. Utilisez le nom du paramètre runtimeconfig.json comme valeur de l’attribut Include. Pour obtenir un exemple, consultez les propriétés MSBuild.

Analyse des dates japonaises

Détermine si une chaîne qui contient « 1 » ou « Gannen » comme année est analysé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 sont correctement analysées. Ceci équivaut à définir la valeur false.
Pour plus d’informations, consultez Représenter les dates dans les 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

Format japonais des années

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

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

NLS

Détermine si .NET utilise les API de globalisation NLS (National Language Support) ou ICU (International Components for Unicode) pour les applications Windows. .NET 5 et versions ultérieures utilisent les API de globalisation ICU par défaut sur la mise à jour de Windows 10 de mai 2019 et versions ultérieures.
Si vous omettez ce paramètre, .NET utilise les API de globalisation ICU par défaut. Ceci équivaut à définir la valeur 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 ICU `true` - Utiliser les API de globalisation NLS	.NET 5
Variable d'environnement	`DOTNET_SYSTEM_GLOBALIZATION_USENLS`	`false` - Utiliser les API de globalisation ICU `true` - Utiliser les API de globalisation NLS	.NET 5

Cultures prédéfinies

Configure si les applications peuvent créer des cultures autres que la culture invariante quand 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. Ceci équivaut à définir la valeur true.
Pour plus d’informations, consultez Création de culture et mappage de casse 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 invariante. `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 invariante. `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 invariante. `false` - Autoriser la création de n’importe quelle culture.	.NET 6