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 Int32.ToString (String, IFormatProvider)

 

Publicado: octubre de 2016

Convierte el valor numérico de esta instancia en su representación de cadena equivalente mediante el formato y la información de formato específica de la referencia cultural que se especificaran.

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

public string ToString(
	string format,
	IFormatProvider provider
)

Parámetros

format
Type: System.String

Cadena de formato numérico estándar o personalizada.

provider
Type: System.IFormatProvider

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

Valor devuelto

Type: System.String

Representación de cadena del valor de esta instancia, tal y como especifican format y provider.

Exception Condition
FormatException

format no es válido o no se admite.

El ToString(String, IFormatProvider) método formatos un Int32 valor en un formato especificado mediante el uso de la NumberFormatInfo objeto de una referencia cultural especificada. Si desea utilizar la configuración predeterminada de formato 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")

Referencia cultural predeterminada de (actual).

ToString()

Formato predeterminado ("G")

Una referencia cultural específica

ToString(IFormatProvider)

Un formato concreto

Referencia cultural predeterminada de (actual).

ToString(String)

El format parámetro puede ser un estándar o una cadena de formato numérico personalizado. Se admiten todas las cadenas de formato numérico estándar que no sea "R" (o "r"), ya que son todos los caracteres de formato numérico personalizado. Si format es null o una cadena vacía (""), el valor devuelto de esta instancia se formatea con el especificador de formato numérico general ("G").

El provider parámetro es un objeto que implementa el IFormatProvider interfaz. Su GetFormat método devuelve un NumberFormatInfo objeto que proporciona información de formato específica de la referencia cultural sobre el formato de la cadena devuelta por este método. El objeto que implementa IFormatProvider puede ser cualquiera de las siguientes acciones:

  • Un CultureInfo objeto que representa la referencia cultural cuyas reglas de formato que se van a utilizar.

  • Un NumberFormatInfo objeto que contiene información de formato numérico específico para este valor.

  • Un objeto personalizado que implementa IFormatProvider y cuyo GetFormat método devuelve un NumberFormatInfo objeto que proporciona información de formato.

Si provider es null o un NumberFormatInfo no se puede obtener el objeto de provider, el valor devuelto de esta instancia se formatea con el NumberFormatInfo para la referencia cultural actual.

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

En el ejemplo siguiente se muestra un valor positivo y negativo utilizando cada uno de los especificadores de formato numérico estándar compatibles para tres referencias culturales diferentes.

// Define cultures whose formatting conventions are to be used.
CultureInfo[] cultures = {CultureInfo.CreateSpecificCulture("en-US"), 
                          CultureInfo.CreateSpecificCulture("fr-FR"), 
                          CultureInfo.CreateSpecificCulture("es-ES") };
int positiveNumber = 1679;
int negativeNumber = -3045;
string[] specifiers = {"G", "C", "D8", "E2", "F", "N", "P", "X8"}; 

foreach (string specifier in specifiers)
{
   foreach (CultureInfo culture in cultures)
   {
      // Display values with "G" format specifier.
      Console.WriteLine("{0} format using {1} culture: {2, 16} {3, 16}",  
                        specifier, culture.Name, 
                        positiveNumber.ToString(specifier, culture), 
                        negativeNumber.ToString(specifier, culture));
   }
   Console.WriteLine();
}
// The example displays the following output:
//       G format using en-US culture:             1679            -3045
//       G format using fr-FR culture:             1679            -3045
//       G format using es-ES culture:             1679            -3045
//       
//       C format using en-US culture:        $1,679.00      ($3,045.00)
//       C format using fr-FR culture:       1 679,00 €      -3 045,00 €
//       C format using es-ES culture:       1.679,00 €      -3.045,00 €
//       
//       D8 format using en-US culture:         00001679        -00003045
//       D8 format using fr-FR culture:         00001679        -00003045
//       D8 format using es-ES culture:         00001679        -00003045
//       
//       E2 format using en-US culture:        1.68E+003       -3.05E+003
//       E2 format using fr-FR culture:        1,68E+003       -3,05E+003
//       E2 format using es-ES culture:        1,68E+003       -3,05E+003
//       
//       F format using en-US culture:          1679.00         -3045.00
//       F format using fr-FR culture:          1679,00         -3045,00
//       F format using es-ES culture:          1679,00         -3045,00
//       
//       N format using en-US culture:         1,679.00        -3,045.00
//       N format using fr-FR culture:         1 679,00        -3 045,00
//       N format using es-ES culture:         1.679,00        -3.045,00
//       
//       P format using en-US culture:     167,900.00 %    -304,500.00 %
//       P format using fr-FR culture:     167 900,00 %    -304 500,00 %
//       P format using es-ES culture:     167.900,00 %    -304.500,00 %
//       
//       X8 format using en-US culture:         0000068F         FFFFF41B
//       X8 format using fr-FR culture:         0000068F         FFFFF41B
//       X8 format using es-ES culture:         0000068F         FFFFF41B

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: