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.

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.

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.

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.

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.

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

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