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

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

Fontes