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

 

Publicado: octubre de 2016

Convierte el valor del objeto Byte actual en la representación de cadena equivalente usando el formato y la información de formato específica de la referencia cultural especificados.

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

La representación de cadena del objeto Byte actual, con el formato especificado por los parámetros format y provider.

Exception Condition
FormatException

format incluye un especificador no compatible. Los especificadores de formato admitidos se muestran en la sección Comentarios.

El ToString(String, IFormatProvider) método formatos un Byte valor en un formato específico de la referencia cultural especificada. Para dar formato a un número con el formato predeterminado ("G") de la referencia cultural actual, llame a la ToString() método. Para dar formato a un número con un formato especificado de la referencia cultural actual, llame a la ToString(String) método.

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 este método 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 específica de la referencia cultural acerca del 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.

Si provider es null o un NumberFormatInfo no se puede obtener el objeto de provider, el valor devuelto se representa con la NumberFormatInfo objeto para la referencia cultural del subproceso actual. Para obtener información acerca de la referencia cultural del subproceso actual, vea Thread.CurrentCulture.

.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 utiliza la cadena de formato estándar "N" y cuatro diferentes CultureInfo objetos para mostrar la representación de cadena de un valor de byte en la consola.

byte byteValue = 250;
CultureInfo[] providers = {new CultureInfo("en-us"), 
                           new CultureInfo("fr-fr"), 
                           new CultureInfo("es-es"), 
                           new CultureInfo("de-de")}; 

foreach (CultureInfo provider in providers) 
   Console.WriteLine("{0} ({1})", 
                     byteValue.ToString("N2", provider), provider.Name);
// The example displays the following output to the console:
//       250.00 (en-US)
//       250,00 (fr-FR)
//       250,00 (es-ES)
//       250,00 (de-DE)      

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: