CKTIS / C#
Formatar Price com IFormattable, IFormatProvider e NumberFormatInfo
Define o contrato de `Price.ToString`, passa as definições numéricas a `decimal` e altera o separador decimal numa cópia editável em vez de alterares o original.
Versão: C# 12 and .NET 8; later runtimes may add compatible features
Sintaxe
System.IFormattable: string ToString(string? format, IFormatProvider? formatProvider);
System.IFormatProvider: object? GetFormat(Type? formatType);
System.Globalization.NumberFormatInfo: public object Clone();
Writable copy: var copy = (NumberFormatInfo)source.Clone();
Direct call: price.ToString("F2", copy)
Composite call: string.Format(copy, "{0:F2}", price)System.IFormattable define o método ToString(format, formatProvider) com dois argumentos. A implementação tem de suportar o formato geral G e aceitar null para selecionar o formato predefinido. O método ToString() sem parâmetros é uma redefinição distinta de object.ToString(). No exemplo, chama a mesma implementação com null em ambos os argumentos.
Price decide que formatos aceita: null, a cadeia vazia, G e g selecionam o formato geral de decimal; F2 e f2 produzem exatamente duas casas decimais, sem agrupamento de algarismos nem símbolo de moeda. Os restantes formatos lançam FormatException. A formatação altera o texto, não o montante armazenado.
System.IFormatProvider fornece definições; não formata o montante. GetFormat(Type?) devolve um objeto do tipo pedido ou null se não puder fornecê-lo. Ao formatar um decimal, CultureInfo fornece as suas definições NumberFormat, enquanto System.Globalization.NumberFormatInfo pode devolver-se a si próprio. Se o fornecedor for null ou não fornecer definições numéricas, decimal usa a cultura atual. No exemplo, string.Format passa F2 e a cópia à implementação de IFormattable.ToString em Price.
NumberFormatInfo.InvariantInfo é só de leitura: definir aí NumberDecimalSeparator lança InvalidOperationException. Clone() devolve uma cópia superficial editável como object. Converte-a explicitamente em NumberFormatInfo e altera o separador na cópia. Passar a cópia a uma chamada não altera o original nem a cultura atual.
Exemplos
#nullable enable
using System;
using System.Globalization;
var price = new Price(1234.5m);
var original = NumberFormatInfo.InvariantInfo;
var copy = (NumberFormatInfo)original.Clone();
copy.NumberDecimalSeparator = ",";
IFormattable formattable = price;
Console.WriteLine(formattable.ToString(null, original));
Console.WriteLine(string.Format(copy, "{0:F2}", price));
Console.WriteLine(price.ToString("F2", original));
public sealed class Price(decimal amount) : IFormattable
{
public override string ToString() => ToString(null, null);
public string ToString(string? format, IFormatProvider? formatProvider)
=> format switch
{
null or "" or "G" or "g" => amount.ToString("G", formatProvider),
"F2" or "f2" => amount.ToString("F2", formatProvider),
_ => throw new FormatException("Unsupported Price format.")
};
}Resultado
1234.5 1234,50 1234.50
A primeira linha mostra o formato predefinido selecionado por `null`. As últimas duas usam `F2`: a vírgula vem da cópia e o ponto vem do original inalterado.
Lições relacionadas
- C# · Lição 33 · Intermédio · Versão: 2