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

CKTIS / C#

IFormatProvider — proporcionar información de formato

System.IFormatProvider proporciona información que se utiliza al dar formato y analizar datos. Su único método, GetFormat, devuelve un objeto del tipo solicitado o null si el proveedor no admite ese tipo.

Versión: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Sintaxis

public interface IFormatProvider
{
    object? GetFormat(Type? formatType);
}

System.IFormatProvider proporciona información para dar formato a valores como texto y analizar texto para obtener valores. Está disponible en .NET 10 y no requiere características del lenguaje en preview. Entre sus implementaciones se encuentran CultureInfo, NumberFormatInfo y DateTimeFormatInfo.

Su único método, IFormatProvider.GetFormat, tiene la firma object? GetFormat(Type? formatType). El código de formato o análisis pasa el tipo del objeto que necesita, como typeof(NumberFormatInfo). El proveedor devuelve un objeto de ese tipo o null cuando no puede proporcionarlo. El resultado no es texto con formato.

Un proveedor y una cadena de formato tienen funciones distintas: "F2" especifica el formato numérico, mientras que el proveedor aporta reglas como el separador decimal. Pasa un proveedor explícitamente a una sobrecarga adecuada de ToString, Parse o TryParse, en lugar de depender de la cultura actual. En el ejemplo, CultureInfo.InvariantCulture hace que el resultado sea previsiblemente 1234.50.

Ejemplos

using System;
using System.Globalization;

IFormatProvider provider = CultureInfo.InvariantCulture;
object? format = provider.GetFormat(typeof(NumberFormatInfo));

Console.WriteLine(format is NumberFormatInfo);
Console.WriteLine(1234.5m.ToString("F2", provider));

Resultado

True
1234.50

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes