Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C#

Formatear Price con IFormattable, IFormatProvider y NumberFormatInfo

Define el contrato de `Price.ToString`, pasa la configuración numérica a `decimal` y cambia el separador decimal en una copia modificable en lugar de en el original.

Versión: C# 12 and .NET 8; later runtimes may add compatible features

Sintaxis

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 el método ToString(format, formatProvider), que recibe dos argumentos. La implementación debe admitir el formato general G y aceptar null para elegir su formato predeterminado. ToString() sin parámetros es una invalidación independiente de object.ToString(). En el ejemplo, llama a la misma implementación pasando null en ambos argumentos.

Price decide qué formatos admite: null, la cadena vacía, G y g seleccionan el formato general de decimal; F2 y f2 muestran exactamente dos cifras decimales, sin agrupación de dígitos ni símbolo de moneda. Los demás formatos provocan FormatException. El formato cambia el texto, no el importe almacenado.

System.IFormatProvider proporciona la configuración; no formatea el importe. GetFormat(Type?) devuelve un objeto del tipo solicitado o null si no puede proporcionarlo. Al formatear un decimal, CultureInfo proporciona su configuración NumberFormat, y System.Globalization.NumberFormatInfo puede devolverse a sí mismo. Si el proveedor es null o no proporciona configuración numérica, decimal usa la cultura actual. En el ejemplo, string.Format pasa F2 y la copia a la implementación de IFormattable.ToString en Price.

NumberFormatInfo.InvariantInfo es de solo lectura: asignarle un valor a NumberDecimalSeparator provoca InvalidOperationException. Clone() devuelve una copia superficial modificable como object. Conviértela explícitamente a NumberFormatInfo y cambia el separador en la copia. Pasar la copia a una llamada no cambia el original ni la cultura actual.

Ejemplos

#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

La primera línea muestra el formato predeterminado que selecciona `null`. Las dos últimas usan `F2`: la coma viene de la copia y el punto, del original sin cambios.

Lecciones relacionadas

  • C# · Lección 33 · Intermedio · Versión: 2

Fuentes