Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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