CKTIS / C#
NumberFormatInfo — regras de formatação numérica
NumberFormatInfo fornece regras para formatar e analisar números, incluindo separadores e símbolos monetários. Conheça os métodos principais, a diferença entre as definições atuais e invariantes e como criar com segurança uma configuração personalizada.
Versão: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Sintaxe
using System.Globalization;
NumberFormatInfo nfi = (NumberFormatInfo)NumberFormatInfo.InvariantInfo.Clone();
string text = value.ToString("N2", nfi);
NumberFormatInfo frozen = NumberFormatInfo.ReadOnly(nfi);NumberFormatInfo de System.Globalization é um IFormatProvider para a formatação e análise de números. Passe-o a métodos como decimal.ToString e decimal.Parse; não disponibiliza, por si só, um método Parse nem um método numérico ToString. NumberDecimalSeparator e NumberGroupSeparator controlam a formatação numérica; as moedas e as percentagens têm propriedades próprias.
Os métodos fundamentais de NumberFormatInfo abordados no curso são GetInstance, GetFormat, Clone e ReadOnly. GetInstance(provider) obtém as definições do fornecedor e recorre à cultura atual se não conseguir obtê-las. Não garante uma cópia editável. GetFormat(typeof(NumberFormatInfo)) devolve o objeto atual; para outro tipo, devolve null.
Clone() devolve uma cópia gravável como object, pelo que é necessária uma conversão de tipo. ReadOnly(nfi) devolve um objeto só de leitura — utilize a referência devolvida. IsReadOnly indica este estado; tentar alterar uma propriedade desse objeto gera InvalidOperationException. ReadOnly(null) gera ArgumentNullException.
CurrentInfo depende da cultura atual. Se atribuir a CultureInfo.CurrentCulture um clone modificável de uma cultura, CurrentInfo pode devolver o objeto NumberFormatInfo modificável desse clone. InvariantInfo fornece regras independentes da cultura e é só de leitura. O exemplo clona InvariantInfo, define os separadores e utiliza "N2" para agrupar com duas casas decimais. A análise utiliza as mesmas regras em conjunto com NumberStyles.Number. O código destina-se a net10.0 e não requer funcionalidades da linguagem em pré-visualização.
Exemplos
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);Resultado
12_345,67 12345.67 True
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.
Fontes
- 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