Int16.ToString Método
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Convierte el valor numérico de esta instancia en la representación de cadena equivalente.
| ToString() |
Convierte el valor numérico de esta instancia en la representación de cadena equivalente. |
| ToString(IFormatProvider) |
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. |
| ToString(String) |
Convierte el valor numérico de esta instancia en la representación de cadena equivalente usando el formato especificado. |
| ToString(String, IFormatProvider) |
Convierte el valor numérico de esta instancia en la representación de cadena equivalente utilizando el formato y la información de formato específica de la referencia cultural especificados. |
- Source:
- Int16.cs
- Source:
- Int16.cs
- Source:
- Int16.cs
Convierte el valor numérico de esta instancia en la representación de cadena equivalente.
public:
override System::String ^ ToString();public override string ToString ();override this.ToString : unit -> stringPublic Overrides Function ToString () As StringDevoluciones
Representación en forma de cadena del valor de esta instancia, que consta de un signo menos si el valor es negativo y una secuencia de dígitos que comprende del 0 al 9 sin ceros a la izquierda.
Ejemplos
En el ejemplo siguiente se usa el ToString() método para mostrar una matriz de Int16 valores en la consola.
short[] numbers = {0, 14624, 13982, short.MaxValue,
short.MinValue, -16667};
foreach (short number in numbers)
{
Console.WriteLine(number.ToString());
}
// The example displays the following output to the console:
// 0
// 14624
// 13982
// 32767
// -32768
// -16667
let numbers = [ 0s; 14624s; 13982s; Int16.MaxValue; Int16.MinValue; -16667s ]
for number in numbers do
printfn $"{number.ToString()}"
// The example displays the following output to the console:
// 0
// 14624
// 13982
// 32767
// -32768
// -16667
Dim numbers() As Short = {0, 14624, 13982, Short.MaxValue, _
Short.MinValue, -16667}
For Each number As Short In numbers
Console.WriteLine(number.ToString())
Next
' The example displays the following output to the console:
' 0
' 14624
' 13982
' 32767
' -32768
' -16667
Comentarios
El ToString() método da formato a un Int16 valor en el formato predeterminado ("G" o general) mediante el NumberFormatInfo objeto de la referencia cultural actual. Si desea especificar otro formato o referencia cultural, use las demás sobrecargas del ToString método , como se indica a continuación:
| Para usar el formato | Para referencia cultural | Uso de la sobrecarga |
|---|---|---|
| Formato predeterminado ("G") | Una referencia cultural específica | ToString(IFormatProvider) |
| Un formato específico | Referencia cultural predeterminada (actual) | ToString(String) |
| Un formato específico | Una referencia cultural específica | ToString(String, IFormatProvider) |
.NET proporciona una amplia compatibilidad con el formato, que se describe con más detalle en los temas de formato siguientes:
Para obtener más información sobre los especificadores de formato numérico, vea Cadenas de formato numérico estándar y Cadenas de formato numérico personalizado.
Para obtener más información sobre el formato, vea Tipos de formato.
Consulte también
Se aplica a
.NET 9 y otras versiones
| Producto | Versiones |
|---|---|
| .NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
| .NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1 |
| UWP | 10.0 |
- Source:
- Int16.cs
- Source:
- Int16.cs
- Source:
- Int16.cs
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.
public:
virtual System::String ^ ToString(IFormatProvider ^ provider);public:
System::String ^ ToString(IFormatProvider ^ provider);public string ToString (IFormatProvider provider);public string ToString (IFormatProvider? provider);override this.ToString : IFormatProvider -> stringPublic Function ToString (provider As IFormatProvider) As StringParámetros
- provider
- IFormatProvider
Un IFormatProvider que proporciona información de formato específica de la referencia cultural.
Devoluciones
Representación en forma de cadena del valor de esta instancia, tal y como especifica provider.
Implementaciones
Ejemplos
En el ejemplo siguiente se itera una matriz de Int16 valores y se muestra cada uno de ellos en la consola mediante una llamada al Int16.ToString(IFormatProvider) método con distintos proveedores de formato. Debido al formato simple definido por el especificador de formato "G" predeterminado, las cadenas con formato generadas para cada Int16 valor son idénticas independientemente del valor del provider parámetro.
short[] numbers = {-23092, 0, 14894, Int16.MaxValue};
CultureInfo[] providers = {new CultureInfo("en-us"),
new CultureInfo("fr-fr"),
new CultureInfo("de-de"),
new CultureInfo("es-es")};
foreach (Int16 int16Value in numbers)
{
foreach (CultureInfo provider in providers)
{
Console.Write("{0, 6} ({1}) ",
int16Value.ToString(provider),
provider.Name);
}
Console.WriteLine();
}
// The example displays the following output to the console:
// -23092 (en-US) -23092 (fr-FR) -23092 (de-DE) -23092 (es-ES)
// 0 (en-US) 0 (fr-FR) 0 (de-DE) 0 (es-ES)
// 14894 (en-US) 14894 (fr-FR) 14894 (de-DE) 14894 (es-ES)
// 32767 (en-US) 32767 (fr-FR) 32767 (de-DE) 32767 (es-ES)
let numbers = [ -23092s; 0s; 14894s; Int16.MaxValue ]
let providers =
[ CultureInfo "en-us"
CultureInfo "fr-fr"
CultureInfo "de-de"
CultureInfo "es-es" ]
for int16Value in numbers do
for provider in providers do
printf $"{int16Value.ToString provider, 6} ({provider.Name}) "
printfn ""
// The example displays the following output to the console:
// -23092 (en-US) -23092 (fr-FR) -23092 (de-DE) -23092 (es-ES)
// 0 (en-US) 0 (fr-FR) 0 (de-DE) 0 (es-ES)
// 14894 (en-US) 14894 (fr-FR) 14894 (de-DE) 14894 (es-ES)
// 32767 (en-US) 32767 (fr-FR) 32767 (de-DE) 32767 (es-ES)
Dim numbers() As Short = {-23092, 0, 14894, Int16.MaxValue}
Dim providers() As CultureInfo = {New CultureInfo("en-us"), _
New CultureInfo("fr-fr"), _
New CultureInfo("de-de"), _
New CultureInfo("es-es")}
For Each int16Value As Short In Numbers
For Each provider As CultureInfo In providers
Console.Write("{0, 6} ({1}) ", _
int16Value.ToString(provider), _
provider.Name)
Next
Console.WriteLine()
Next
' The example displays the following output to the console:
' -23092 (en-US) -23092 (fr-FR) -23092 (de-DE) -23092 (es-ES)
' 0 (en-US) 0 (fr-FR) 0 (de-DE) 0 (es-ES)
' 14894 (en-US) 14894 (fr-FR) 14894 (de-DE) 14894 (es-ES)
' 32767 (en-US) 32767 (fr-FR) 32767 (de-DE) 32767 (es-ES)
Comentarios
El ToString(IFormatProvider) método da formato a un Int16 valor en el formato predeterminado ("G" o general) mediante el NumberFormatInfo objeto de una referencia cultural especificada. Si desea especificar un formato diferente o la referencia cultural actual, use las demás sobrecargas del ToString método , como se indica a continuación:
| Para usar el formato | Para referencia cultural | Uso de la sobrecarga |
|---|---|---|
| Formato predeterminado ("G") | Referencia cultural predeterminada (actual) | ToString() |
| Un formato específico | Referencia cultural predeterminada (actual) | ToString(String) |
| Un formato específico | Una referencia cultural específica | ToString(String, IFormatProvider) |
.NET proporciona una amplia compatibilidad con el formato, que se describe con más detalle en los temas de formato siguientes:
Para obtener más información sobre los especificadores de formato numérico, vea Cadenas de formato numérico estándar y Cadenas de formato numérico personalizado.
Para obtener más información sobre el formato, vea Tipos de formato.
El provider parámetro es una IFormatProvider implementación cuyo IFormatProvider.GetFormat método devuelve un NumberFormatInfo objeto . Normalmente, provider es un NumberFormatInfo objeto o un CultureInfo objeto . El NumberFormatInfo objeto proporciona información específica de la referencia cultural sobre el formato de la cadena devuelta por este método. Si provider es null, esta instancia tiene el formato del NumberFormatInfo objeto para la referencia cultural actual.
Consulte también
Se aplica a
.NET 9 y otras versiones
| Producto | Versiones |
|---|---|
| .NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
| .NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1 |
| UWP | 10.0 |
- Source:
- Int16.cs
- Source:
- Int16.cs
- Source:
- Int16.cs
Convierte el valor numérico de esta instancia en la representación de cadena equivalente usando el formato especificado.
public:
System::String ^ ToString(System::String ^ format);public string ToString (string format);public string ToString (string? format);override this.ToString : string -> stringPublic Function ToString (format As String) As StringParámetros
- format
- String
Cadena de formato numérico.
Devoluciones
Representación en forma de cadena del valor de esta instancia, tal y como especifica format.
Ejemplos
En el ejemplo siguiente se inicializan dos Int16 valores y se muestran en la consola mediante cada una de las cadenas de formato estándar admitidas y varias cadenas de formato personalizado. El ejemplo se ejecuta con en-US como referencia cultural actual.
Int16[] values = {-23805, 32194};
string[] formats = {"C4", "D6", "e1", "E2", "F1", "G", "N1",
"P0", "X4", "000000.0000", "##000.0"};
foreach (string format in formats)
{
Console.WriteLine("'{0,2}' format specifier: {1,17} {2,17}",
format,
values[0].ToString(format),
values[1].ToString(format));
}
// The example displays the following output to the console:
// 'C4' format specifier: ($23,805.0000) $32,194.0000
// 'D6' format specifier: -023805 032194
// 'e1' format specifier: -2.4e+004 3.2e+004
// 'E2' format specifier: -2.38E+004 3.22E+004
// 'F1' format specifier: -23805.0 32194.0
// ' G' format specifier: -23805 32194
// 'N1' format specifier: -23,805.0 32,194.0
// 'P0' format specifier: -2,380,500 % 3,219,400 %
// 'X4' format specifier: A303 7DC2
// '000000.0000' format specifier: -023805.0000 032194.0000
// '##000.0' format specifier: -23805.0 32194.0
let values = [| -23805s; 32194s |]
let formats =
[ "C4"; "D6"; "e1"; "E2"; "F1"; "G"; "N1"
"P0"; "X4"; "000000.0000"; "##000.0" ]
for format in formats do
printfn $"'{format,2}' format specifier: {values[0].ToString format,17} {values[1].ToString format,17}"
// The example displays the following output to the console:
// 'C4' format specifier: ($23,805.0000) $32,194.0000
// 'D6' format specifier: -023805 032194
// 'e1' format specifier: -2.4e+004 3.2e+004
// 'E2' format specifier: -2.38E+004 3.22E+004
// 'F1' format specifier: -23805.0 32194.0
// ' G' format specifier: -23805 32194
// 'N1' format specifier: -23,805.0 32,194.0
// 'P0' format specifier: -2,380,500 % 3,219,400 %
// 'X4' format specifier: A303 7DC2
// '000000.0000' format specifier: -023805.0000 032194.0000
// '##000.0' format specifier: -23805.0 32194.0
Dim values() As Int16 = {-23805, 32194}
Dim formats() As String = {"C4", "D6", "e1", "E2", "F1", "G", "N1", _
"P0", "X4", "000000.0000", "##000.0"}
For Each format As String In formats
Console.WriteLine("'{0,2}' format specifier: {1,17} {2,17}", _
format, _
values(0).ToString(format), _
values(1).ToString(format))
Next
' The example displays the following output to the console:
' 'C4' format specifier: ($23,805.0000) $32,194.0000
' 'D6' format specifier: -023805 032194
' 'e1' format specifier: -2.4e+004 3.2e+004
' 'E2' format specifier: -2.38E+004 3.22E+004
' 'F1' format specifier: -23805.0 32194.0
' ' G' format specifier: -23805 32194
' 'N1' format specifier: -23,805.0 32,194.0
' 'P0' format specifier: -2,380,500 % 3,219,400 %
' 'X4' format specifier: A303 7DC2
' '000000.0000' format specifier: -023805.0000 032194.0000
' '##000.0' format specifier: -23805.0 32194.0
Comentarios
El ToString(String) método da formato a un Int16 valor en un formato especificado mediante un NumberFormatInfo objeto que representa las convenciones de la referencia cultural actual. Si desea usar el formato predeterminado ("G" o general) o especificar una referencia cultural diferente, use las demás sobrecargas del ToString método, como se indica a continuación:
| Para usar el formato | Para referencia cultural | Uso de la sobrecarga |
|---|---|---|
| Formato predeterminado ("G") | Referencia cultural predeterminada (actual) | ToString() |
| Formato predeterminado ("G") | Una referencia cultural específica | ToString(IFormatProvider) |
| Un formato específico | Una referencia cultural específica | ToString(String, IFormatProvider) |
El format parámetro puede ser una cadena de formato numérico estándar o personalizada. Se admiten todas las cadenas de formato numérico estándar que no sean "R" (o "r"), al igual que todos los caracteres de formato numérico personalizado. Si format es null o una cadena vacía, se da formato al valor devuelto de esta instancia con el especificador de formato numérico general ("G").
.NET proporciona una amplia compatibilidad con el formato, que se describe con más detalle en los temas de formato siguientes:
Para obtener más información sobre los especificadores de formato numérico, vea Cadenas de formato numérico estándar y Cadenas de formato numérico personalizado.
Para obtener más información sobre el formato, vea Tipos de formato.
El valor devuelto de esta instancia tiene el formato NumberFormatInfo para la referencia cultural actual.
Consulte también
- Parse(String)
- String
- Aplicar formato a tipos en .NET
- Cadenas con formato numérico estándar
- Cadenas con formato numérico personalizado
- Cómo: Rellenar un número con ceros a la izquierda
Se aplica a
.NET 9 y otras versiones
| Producto | Versiones |
|---|---|
| .NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
| .NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1 |
| UWP | 10.0 |
- Source:
- Int16.cs
- Source:
- Int16.cs
- Source:
- Int16.cs
Convierte el valor numérico de esta instancia en la representación de cadena equivalente utilizando el formato y la información de formato específica de la referencia cultural especificados.
public:
virtual System::String ^ ToString(System::String ^ format, IFormatProvider ^ provider);public string ToString (string format, IFormatProvider provider);public string ToString (string? format, IFormatProvider? provider);override this.ToString : string * IFormatProvider -> stringPublic Function ToString (format As String, provider As IFormatProvider) As StringParámetros
- format
- String
Cadena de formato numérico.
- provider
- IFormatProvider
Objeto que proporciona información de formato específica de la referencia cultural.
Devoluciones
Representación de cadena del valor de esta instancia, tal y como especifican format y provider.
Implementaciones
Ejemplos
En el ejemplo siguiente se muestra un Int16 valor que usa cada una de las cadenas de formato estándar admitidas en cuatro referencias culturales diferentes.
Int16 value = 14603;
string[] formats = {"C", "D6", "e1", "E2", "F1", "G", "N1",
"P0", "X4", "000000.0000", "##000.0"};
CultureInfo[] providers = {new CultureInfo("en-us"),
new CultureInfo("fr-fr"),
new CultureInfo("de-de"),
new CultureInfo("es-es")};
// Display header.
Console.WriteLine("{0,24}{1,14}{2,14}{3,14}", providers[0], providers[1],
providers[2], providers[3]);
Console.WriteLine();
// Display a value using each format string.
foreach (string format in formats)
{
// Display the value for each provider on the same line.
Console.Write("{0,-12}", format);
foreach (CultureInfo provider in providers)
{
Console.Write("{0,12} ",
value.ToString(format, provider));
}
Console.WriteLine();
}
// The example displays the following output to the console:
// en-US fr-FR de-DE es-ES
//
// C $14,603.00 14 603,00 € 14.603,00 € 14.603,00 €
// D6 014603 014603 014603 014603
// e1 1.5e+004 1,5e+004 1,5e+004 1,5e+004
// E2 1.46E+004 1,46E+004 1,46E+004 1,46E+004
// F1 14603.0 14603,0 14603,0 14603,0
// G 14603 14603 14603 14603
// N1 14,603.0 14 603,0 14.603,0 14.603,0
// P0 1,460,300 % 1 460 300 % 1.460.300% 1.460.300 %
// X4 390B 390B 390B 390B
// 000000.0000 014603.0000 014603,0000 014603,0000 014603,0000
// ##000.0 14603.0 14603,0 14603,0 14603,0
let value = 14603
let formats =
[ "C"; "D6"; "e1"; "E2"; "F1"; "G"; "N1"
"P0"; "X4"; "000000.0000"; "##000.0" ]
let providers =
[ CultureInfo "en-us"
CultureInfo "fr-fr"
CultureInfo "de-de"
CultureInfo "es-es" ]
// Display header.
printfn $"{providers[0],24}{providers[1],14}{providers[2],14}{providers[3],14}\n"
// Display a value using each format string.
for format in formats do
// Display the value for each provider on the same line.
printf $"{format,-12}"
for provider in providers do
printf $"{value.ToString(format, provider),12} "
printfn ""
// The example displays the following output to the console:
// en-US fr-FR de-DE es-ES
//
// C $14,603.00 14 603,00 € 14.603,00 € 14.603,00 €
// D6 014603 014603 014603 014603
// e1 1.5e+004 1,5e+004 1,5e+004 1,5e+004
// E2 1.46E+004 1,46E+004 1,46E+004 1,46E+004
// F1 14603.0 14603,0 14603,0 14603,0
// G 14603 14603 14603 14603
// N1 14,603.0 14 603,0 14.603,0 14.603,0
// P0 1,460,300 % 1 460 300 % 1.460.300% 1.460.300 %
// X4 390B 390B 390B 390B
// 000000.0000 014603.0000 014603,0000 014603,0000 014603,0000
// ##000.0 14603.0 14603,0 14603,0 14603,0
Dim value As Int16 = 14603
Dim formats() As String = {"C", "D6", "e1", "E2", "F1", "G", "N1", _
"P0", "X4", "000000.0000", "##000.0"}
Dim providers() As CultureInfo = {New CultureInfo("en-us"), _
New CultureInfo("fr-fr"), _
New CultureInfo("de-de"), _
New CultureInfo("es-es")}
' Display header.
Console.WriteLine("{0,24}{1,14}{2,14}{3,14}", providers(0), providers(1), _
providers(2), providers(3))
Console.WriteLine()
' Display a value using each format string.
For Each format As String In formats
' Display the value for each provider on the same line.
Console.Write("{0,-12}", format)
For Each provider As CultureInfo In providers
Console.Write("{0,12} ", _
value.ToString(format, provider))
Next
Console.WriteLine()
Next
' The example displays the following output to the console:
' en-US fr-FR de-DE es-ES
'
' C $14,603.00 14 603,00 € 14.603,00 € 14.603,00 €
' D6 014603 014603 014603 014603
' e1 1.5e+004 1,5e+004 1,5e+004 1,5e+004
' E2 1.46E+004 1,46E+004 1,46E+004 1,46E+004
' F1 14603.0 14603,0 14603,0 14603,0
' G 14603 14603 14603 14603
' N1 14,603.0 14 603,0 14.603,0 14.603,0
' P0 1,460,300 % 1 460 300 % 1.460.300% 1.460.300 %
' X4 390B 390B 390B 390B
' 000000.0000 014603.0000 014603,0000 014603,0000 014603,0000
' ##000.0 14603.0 14603,0 14603,0 14603,0
Comentarios
El ToString(String, IFormatProvider) método da formato a un Int16 valor en un formato especificado mediante el NumberFormatInfo objeto de una referencia cultural especificada. Si desea usar la configuración predeterminada de formato o referencia cultural, use las demás sobrecargas del ToString método , como se indica a continuación:
| Para usar el formato | Para referencia cultural | Uso de la sobrecarga |
|---|---|---|
| Formato predeterminado ("G") | Referencia cultural predeterminada (actual) | ToString() |
| Formato predeterminado ("G") | Una referencia cultural específica | ToString(IFormatProvider) |
| Un formato específico | Referencia cultural predeterminada (actual) | ToString(String) |
El format parámetro puede ser una cadena de formato numérico estándar o personalizada. Se admiten todas las cadenas de formato numérico estándar que no sean "R" (o "r"), al igual que todos los caracteres de formato numérico personalizado. Si format es null o una cadena vacía (""), la cadena devuelta por este método tiene el formato del especificador de formato numérico general ("G").
.NET proporciona una amplia compatibilidad con el formato, que se describe con más detalle en los temas de formato siguientes:
Para obtener más información sobre los especificadores de formato numérico, vea Cadenas de formato numérico estándar y Cadenas de formato numérico personalizado.
Para obtener más información sobre el formato, vea Tipos de formato.
El provider parámetro es una IFormatProvider implementación. Su GetFormat método devuelve un NumberFormatInfo objeto que proporciona información 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 los siguientes:
Objeto CultureInfo que representa la referencia cultural cuyas reglas de formato se van a usar.
Objeto NumberFormatInfo que contiene información de formato numérico específica para este valor.
Objeto personalizado que implementa IFormatProvider.
Si provider es null, o un NumberFormatInfo objeto no se puede obtener de provider, el valor devuelto tiene el formato para NumberFormatInfo la referencia cultural actual.
Consulte también
- Parse(String)
- Aplicar formato a tipos en .NET
- Cadenas con formato numérico estándar
- Cadenas con formato numérico personalizado
- Cómo: Rellenar un número con ceros a la izquierda
- Ejemplo: Utilidad de formato WinForms de .NET Core (C#)
- Ejemplo: Utilidad de formato WinForms de .NET Core (Visual Basic)
Se aplica a
.NET 9 y otras versiones
| Producto | Versiones |
|---|---|
| .NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
| .NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1 |
| UWP | 10.0 |
Comentarios de .NET
.NET es un proyecto de código abierto. Seleccione un vínculo para proporcionar comentarios: