Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Método Double.ToString (IFormatProvider)

 

Publicado: octubre de 2016

Convierte el valor numérico de esta instancia en la representación de cadena equivalente usando la información de formato específica de la referencia cultural especificada.

Espacio de nombres:   System
Ensamblado:  mscorlib (en mscorlib.dll)

public string ToString(
	IFormatProvider provider
)

Parámetros

provider
Type: System.IFormatProvider

Objeto que proporciona información de formato específica de la referencia cultural.

Valor devuelto

Type: System.String

Representación en forma de cadena del valor de esta instancia, tal y como especifica provider.

El ToString(IFormatProvider) método formatos un Double valor en el valor predeterminado ("G" o general), formato de una referencia cultural especificada. Si desea especificar un formato diferente o la referencia cultural, use las otras sobrecargas de la ToString método, tal como se indica a continuación:

Usar formato

Para la referencia cultural

Use la sobrecarga

Formato predeterminado ("G")

Predeterminado (actual).

ToString()

Un formato concreto o la precisión

Referencia cultural predeterminada de (actual).

ToString(String)

Un formato concreto o la precisión

Una referencia cultural específica

ToString(String, IFormatProvider)

El valor devuelto puede ser PositiveInfinitySymbol, NegativeInfinitySymbol, NaNSymbol, o una cadena del formulario:

[signo] dígitos enteros [.[dígitos fraccionarios]] [e [signo] dígitos exponenciales]

Elementos opcionales están entre corchetes ([y]). Elementos que contienen el término "dígitos" constan de una serie de caracteres numéricos comprendidos entre 0 y 9. Se admiten los elementos enumerados en la tabla siguiente.

Elemento

Descripción

signo

Un signo negativo o el símbolo de signo positivo.

dígitos enteros

Una serie de dígitos que especifican la parte entera del número. Dígitos enteros pueden no estar presentes si hay dígitos fraccionarios.

'.'

Un símbolo de separador decimal de referencias culturales específicas.

dígitos fraccionarios

Una serie de dígitos que especifican la parte fraccionaria del número.

'e'

Un carácter en minúscula 'e', que indica una notación exponencial (científica).

dígitos exponenciales

Una serie de dígitos que especifican a un exponente.

Algunos ejemplos del valor devuelto son "100", "-123,456,789", "123. 45e + 6", "500", "3.1416", "600", "-0.123" y "-Infinity".

Esta instancia está formateada con el especificador de formato numérico general ("G").

.NET Framework proporciona una amplia compatibilidad de formato, que se describe con más detalle en los temas de formato siguientes:

El provider parámetro es un IFormatProvider implementación cuyo GetFormat método devuelve un NumberFormatInfo objeto. Por lo general, provider es un CultureInfo objeto o un NumberFormatInfo objeto. El provider parámetro proporciona información específica de la referencia cultural utilizada para dar formato. Si provider es null, el valor devuelto se representa con la NumberFormatInfo objeto para la referencia cultural actual.

En el ejemplo siguiente se muestra la representación de cadena de dos Double valores mediante CultureInfo objetos que representan varias referencias culturales diferentes.

double value;

value = -16325.62015;
// Display value using the invariant culture.
Console.WriteLine(value.ToString(CultureInfo.InvariantCulture));
// Display value using the en-GB culture.
Console.WriteLine(value.ToString(CultureInfo.CreateSpecificCulture("en-GB")));
// Display value using the de-DE culture.
Console.WriteLine(value.ToString(CultureInfo.CreateSpecificCulture("de-DE")));

value = 16034.125E21;
// Display value using the invariant culture.
Console.WriteLine(value.ToString(CultureInfo.InvariantCulture));
// Display value using the en-GB culture.
Console.WriteLine(value.ToString(CultureInfo.CreateSpecificCulture("en-GB")));
// Display value using the de-DE culture.
Console.WriteLine(value.ToString(CultureInfo.CreateSpecificCulture("de-DE")));
// This example displays the following output to the console:
//       -16325.62015
//       -16325.62015
//       -16325,62015
//       1.6034125E+25
//       1.6034125E+25
//       1,6034125E+25

En el ejemplo siguiente se muestra el uso de ToString, teniendo un String y un IFormatProvider como parámetros.

public class Temperature : IFormattable {
	// IFormattable.ToString implementation.
	public string ToString(string format, IFormatProvider provider) {
		if( format != null ) {
			if( format.Equals("F") ) {
				return String.Format("{0}'F", this.Value.ToString());
			}
			if( format.Equals("C") ) {
				return String.Format("{0}'C", this.Celsius.ToString());
			}
		}

		return m_value.ToString(format, provider);
	}

	// The value holder
	protected double m_value;

	public double Value {
		get {
			return m_value;
		}
		set {
			m_value = value;
		}
	}

	public double Celsius {
		get {
			return (m_value-32.0)/1.8;
		}
		set {
			m_value = 1.8*value+32.0;
		}
	}
}

Plataforma universal de Windows
Disponible desde 8
.NET Framework
Disponible desde 1.1
Biblioteca de clases portable
Se admite en: plataformas portátiles de .NET
Silverlight
Disponible desde 2.0
Windows Phone Silverlight
Disponible desde 7.0
Windows Phone
Disponible desde 8.1
Volver al principio
Mostrar: