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

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.

Fontes