Partager via


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 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

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

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.

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

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.

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

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.

Cultures prédéfinies

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