CKTIS / C#
IFormatProvider — fornecer informações de formatação
System.IFormatProvider fornece informações utilizadas durante a formatação e a análise. O seu único método, GetFormat, devolve um objeto do tipo pedido ou null se o fornecedor não suportar esse tipo.
Versão: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Sintaxe
public interface IFormatProvider
{
object? GetFormat(Type? formatType);
}System.IFormatProvider fornece informações para formatar valores como texto e analisar texto para obter valores. Está disponível no .NET 10 e não requer funcionalidades da linguagem em preview. Entre as implementações encontram-se CultureInfo, NumberFormatInfo e DateTimeFormatInfo.
O seu único método, IFormatProvider.GetFormat, tem a assinatura object? GetFormat(Type? formatType). O código de formatação ou análise passa o tipo do objeto de que necessita, por exemplo, typeof(NumberFormatInfo). O fornecedor devolve um objeto desse tipo ou null quando não o consegue fornecer. O resultado não é texto formatado.
Um fornecedor e uma cadeia de formato têm funções diferentes: "F2" especifica o formato numérico, enquanto o fornecedor disponibiliza regras como o separador decimal. Passe explicitamente um fornecedor para uma sobrecarga adequada de ToString, Parse ou TryParse, em vez de depender da cultura atual. No exemplo, CultureInfo.InvariantCulture torna previsível o resultado 1234.50.
Exemplos
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
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.