CKTIS / C#
Double.ToString — formatar um número com um fornecedor explícito
Double.ToString(string, IFormatProvider) converte um valor double em texto e permite escolher separadamente o formato numérico e as regras culturais. Se o método GetFormat do fornecedor devolver null quando lhe for pedido um objeto NumberFormatInfo, a formatação utiliza as regras da cultura atual.
Versão: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Sintaxe
public string ToString(string? format, IFormatProvider? provider);Double.ToString(string, IFormatProvider) devolve uma representação textual de um valor double. O parâmetro format seleciona a notação, enquanto provider fornece as regras culturais, normalmente através de CultureInfo ou NumberFormatInfo.
ToString() utiliza "G" e a cultura atual. ToString(string) altera apenas o formato, enquanto ToString(IFormatProvider) altera apenas o fornecedor das regras de formatação. Na sobrecarga com dois argumentos, um format null ou vazio significa "G"; um provider null significa a cultura atual.
"F2" produz dois algarismos após o separador decimal, enquanto "N2" também agrupa os algarismos. A formatação pode arredondar o texto resultante, mas não altera o valor armazenado. No .NET 10, um especificador de formato numérico não suportado, como "D", provoca uma FormatException para valores finitos do tipo double. Para NaN e para os infinitos positivo e negativo, o método devolve o símbolo correspondente à cultura utilizada antes de validar o especificador, pelo que "D" não provoca uma exceção para esses valores.
O exemplo utiliza CultureInfo.InvariantCulture e uma cópia das respetivas regras de formatação com um separador decimal diferente. Assim, demonstra a diferença entre 1234.50 e 1234,50 sem depender das definições regionais do computador.
Exemplos
using System;
using System.Globalization;
double value = 1234.5;
var commaFormat = (NumberFormatInfo)CultureInfo.InvariantCulture.NumberFormat.Clone();
commaFormat.NumberDecimalSeparator = ",";
Console.WriteLine(value.ToString("F2", CultureInfo.InvariantCulture));
Console.WriteLine(value.ToString("F2", commaFormat));Resultado
1234.50 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.