CKTIS / C#
NumberFormatInfo — règles de formatage des nombres
NumberFormatInfo fournit des règles pour formater et analyser les nombres, notamment les séparateurs et les symboles monétaires. Découvrez ses méthodes principales, la différence entre les paramètres actuels et invariants, ainsi que la création sûre d’une configuration personnalisée.
Version : .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Syntaxe
using System.Globalization;
NumberFormatInfo nfi = (NumberFormatInfo)NumberFormatInfo.InvariantInfo.Clone();
string text = value.ToString("N2", nfi);
NumberFormatInfo frozen = NumberFormatInfo.ReadOnly(nfi);NumberFormatInfo dans System.Globalization est un IFormatProvider pour le formatage et l’analyse des nombres. Transmettez-le à des méthodes telles que decimal.ToString et decimal.Parse ; il ne fournit pas lui-même de méthode Parse ni de méthode numérique ToString. NumberDecimalSeparator et NumberGroupSeparator contrôlent le formatage des nombres ; les devises et les pourcentages ont des propriétés distinctes.
Les principales méthodes de NumberFormatInfo abordées dans le cours sont GetInstance, GetFormat, Clone et ReadOnly. GetInstance(provider) récupère les paramètres du fournisseur et utilise la culture actuelle s’il ne parvient pas à les obtenir. Il ne garantit pas une copie modifiable. GetFormat(typeof(NumberFormatInfo)) renvoie l’objet actuel ; pour un autre type, il renvoie null.
Clone() renvoie une copie modifiable sous forme d’object ; un cast est donc nécessaire. ReadOnly(nfi) renvoie un objet en lecture seule — utilisez la référence renvoyée. IsReadOnly indique cet état ; la tentative de modifier une propriété d’un tel objet déclenche InvalidOperationException. ReadOnly(null) déclenche ArgumentNullException.
CurrentInfo dépend de la culture actuelle. Si vous affectez à CultureInfo.CurrentCulture un clone modifiable d’une culture, CurrentInfo peut renvoyer l’objet NumberFormatInfo modifiable de ce clone. InvariantInfo fournit des règles indépendantes de la culture et est en lecture seule. L’exemple clone InvariantInfo, définit les séparateurs et utilise "N2" pour le groupement avec deux décimales. L’analyse utilise les mêmes règles avec NumberStyles.Number. Le code cible net10.0 et ne nécessite aucune fonctionnalité du langage en préversion.
Exemples
using System;
using System.Globalization;
NumberFormatInfo nfi = (NumberFormatInfo)NumberFormatInfo.InvariantInfo.Clone();
nfi.NumberDecimalSeparator = ",";
nfi.NumberGroupSeparator = "_";
nfi.NumberGroupSizes = new[] { 3 };
NumberFormatInfo frozen = NumberFormatInfo.ReadOnly(nfi);
string text = 12345.67m.ToString("N2", frozen);
Console.WriteLine(text);
decimal parsed = decimal.Parse(text, NumberStyles.Number, frozen);
Console.WriteLine(parsed.ToString("F2", CultureInfo.InvariantCulture));
Console.WriteLine(frozen.IsReadOnly);Résultat
12_345,67 12345.67 True
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.
Sources
- NumberFormatInfo Class (System.Globalization) | Microsoft Learn
- NumberFormatInfo.GetInstance(IFormatProvider) Method (System.Globalization) | Microsoft Learn
- NumberFormatInfo.GetFormat(Type) Method (System.Globalization) | Microsoft Learn
- NumberFormatInfo.Clone Method (System.Globalization) | Microsoft Learn
- NumberFormatInfo.ReadOnly(NumberFormatInfo) Method (System.Globalization) | Microsoft Learn