CKTIS / C#
NumberFormatInfo — regole di formattazione dei numeri
NumberFormatInfo fornisce regole per formattare e analizzare i numeri, inclusi separatori e simboli di valuta. Scopri i metodi principali, la differenza tra impostazioni correnti e invarianti e come creare in modo sicuro una configurazione personalizzata.
Versione: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Sintassi
using System.Globalization;
NumberFormatInfo nfi = (NumberFormatInfo)NumberFormatInfo.InvariantInfo.Clone();
string text = value.ToString("N2", nfi);
NumberFormatInfo frozen = NumberFormatInfo.ReadOnly(nfi);NumberFormatInfo di System.Globalization è un IFormatProvider per la formattazione e l’analisi dei numeri. Passalo a metodi come decimal.ToString e decimal.Parse; non espone direttamente un metodo Parse né un metodo numerico ToString. NumberDecimalSeparator e NumberGroupSeparator controllano la formattazione dei numeri; valute e percentuali hanno proprietà separate.
I metodi fondamentali di NumberFormatInfo trattati nel corso sono GetInstance, GetFormat, Clone e ReadOnly. GetInstance(provider) recupera le impostazioni del provider e usa la cultura corrente se non riesce a ottenerle. Non garantisce una copia modificabile. GetFormat(typeof(NumberFormatInfo)) restituisce l’oggetto corrente; per un altro tipo restituisce null.
Clone() restituisce una copia scrivibile come object, quindi è necessario un cast. ReadOnly(nfi) restituisce un oggetto di sola lettura: usa il riferimento restituito. IsReadOnly indica questo stato; il tentativo di modificare una proprietà di tale oggetto genera InvalidOperationException. ReadOnly(null) genera ArgumentNullException.
CurrentInfo dipende dalla cultura corrente. Se assegni a CultureInfo.CurrentCulture un clone modificabile di una cultura, CurrentInfo può restituire l’oggetto NumberFormatInfo modificabile di quel clone. InvariantInfo fornisce regole indipendenti dalla cultura ed è di sola lettura. L’esempio clona InvariantInfo, imposta i separatori e usa "N2" per il raggruppamento con due cifre decimali. L’analisi usa le stesse regole insieme a NumberStyles.Number. Il codice è destinato a net10.0 e non richiede funzionalità del linguaggio in anteprima.
Esempi
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);Risultato
12_345,67 12345.67 True
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.
Fonti
- 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