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

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.

Fontes