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

CKTIS / C#

Double.ToString — dar formato a un número con un proveedor explícito

Double.ToString(string, IFormatProvider) convierte un valor double en texto y permite elegir por separado el formato numérico y las reglas culturales. Si el método GetFormat del proveedor devuelve null al solicitar un objeto NumberFormatInfo, se aplican las reglas de la cultura actual.

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

Sintaxis

public string ToString(string? format, IFormatProvider? provider);

Double.ToString(string, IFormatProvider) devuelve una representación textual de un valor double. El parámetro format selecciona la notación, mientras que provider proporciona las reglas culturales, normalmente mediante CultureInfo o NumberFormatInfo.

ToString() usa "G" y la cultura actual. ToString(string) cambia solo el formato, mientras que ToString(IFormatProvider) cambia solo el proveedor de las reglas de formato. En la sobrecarga de dos argumentos, un format null o vacío significa "G"; un provider null significa la cultura actual.

"F2" produce dos cifras después del separador decimal, mientras que "N2" también agrupa las cifras. El formato puede redondear el texto resultante, pero no cambia el valor almacenado. En .NET 10, un especificador de formato numérico no admitido, como "D", provoca una FormatException para los valores finitos de tipo double. Para NaN y los infinitos positivo y negativo, el método devuelve el símbolo correspondiente a la cultura utilizada antes de validar el especificador, por lo que "D" no provoca una excepción para esos valores.

El ejemplo usa CultureInfo.InvariantCulture y una copia de sus reglas de formato con un separador decimal distinto. Así muestra la diferencia entre 1234.50 y 1234,50 sin depender de la configuración regional del equipo.

Ejemplos

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

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