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éder aux données et au comportement propres à la culture.
  • Si vous omettez ce paramètre, l’application s’exécute avec l’accès aux données culturelles. Ceci équivaut à définir la valeur sur false.
  • Pour plus d’informations, consultez le mode invariant de la globalisation .NET Core.
Nom du paramètre Valeurs
runtimeconfig.json System.Globalization.Invariant false - accès aux données culturelles
true - s’exécuter en mode invariant
Propriété MSBuild InvariantGlobalization false - accès aux données culturelles
true - s’exécuter en mode invariant
Variable d'environnement DOTNET_SYSTEM_GLOBALIZATION_INVARIANT 0 - accès aux données culturelles
1 - s’exécuter en mode invariant

Examples

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 de dates japonaises

  • Détermine si une chaîne qui contient « 1 » ou « Gannen » comme analyse 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 analyse de l’année avec succès. Ceci équivaut à définir la valeur sur 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 de l’année japonaise

  • Détermine si la première année d’une ère de calendrier japonaise est mise en forme comme « Gannen » ou comme un nombre.
  • Si vous omettez ce paramètre, la première année est mise en forme comme « Gannen ». Ceci équivaut à définir la valeur sur 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 - format « Gannen »
true - format 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 la prise en charge des langues nationales (NLS) ou des composants internationaux pour les API de globalisation Unicode (ICU) pour les applications Windows. Les versions .NET 5 et ultérieures utilisent les API de globalisation iCU par défaut sur Windows 10 mai 2019 Update 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 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 de l’ICU
true - Utiliser les API de globalisation NLS
.NET 5
Variable d'environnement DOTNET_SYSTEM_GLOBALIZATION_USENLS false - Utiliser les API de globalisation de l’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