SByte.ToString Método
Definición
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.
Sobrecargas
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 su representación de cadena equivalente mediante el formato y la información de formato específica de la referencia cultural que se especificaran. |
ToString()
- Source:
- SByte.cs
- Source:
- SByte.cs
- Source:
- SByte.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 -> string
Public Overrides Function ToString () As String
Devoluciones
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 muestra un SByte valor mediante el método predeterminado ToString() . También muestra las representaciones de cadena del SByte valor resultantes del uso de una serie de especificadores de formato estándar. Los ejemplos se muestran mediante las convenciones de formato de la referencia cultural en-US.
using System;
public class Example
{
public static void Main()
{
sbyte value = -123;
// Display value using default ToString method.
Console.WriteLine(value.ToString()); // Displays -123
// Display value using some standard format specifiers.
Console.WriteLine(value.ToString("G")); // Displays -123
Console.WriteLine(value.ToString("C")); // Displays ($-123.00)
Console.WriteLine(value.ToString("D")); // Displays -123
Console.WriteLine(value.ToString("F")); // Displays -123.00
Console.WriteLine(value.ToString("N")); // Displays -123.00
Console.WriteLine(value.ToString("X")); // Displays 85
}
}
let value = -123y
// Display value using default ToString method.
printfn $"{value.ToString()}" // Displays -123
// Display value using some standard format specifiers.
printfn $"""{value.ToString "G"}""" // Displays -123
printfn $"""{value.ToString "C"}""" // Displays ($-123.00)
printfn $"""{value.ToString "D"}""" // Displays -123
printfn $"""{value.ToString "F"}""" // Displays -123.00
printfn $"""{value.ToString "N"}""" // Displays -123.00
printfn $"""{value.ToString "X"}""" // Displays 85
Module Example
Public Sub Main()
Dim value As SByte = -123
' Display value using default ToString method.
Console.WriteLine(value.ToString()) ' Displays -123
' Display value using some standard format specifiers.
Console.WriteLine(value.ToString("G")) ' Displays -123
Console.WriteLine(value.ToString("C")) ' Displays ($-123.00)
Console.WriteLine(value.ToString("D")) ' Displays -123
Console.WriteLine(value.ToString("F")) ' Displays -123.00
Console.WriteLine(value.ToString("N")) ' Displays -123.00
Console.WriteLine(value.ToString("X")) ' Displays 85
End Sub
End Module
Comentarios
El ToString() método da formato a un SByte valor en el formato predeterminado ("G" o general) de la referencia cultural actual. Si desea especificar un formato o 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") | 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) |
El valor devuelto se da formato mediante el especificador de formato numérico general ("G") La representación de cadena del SByte valor incluye un signo negativo si su valor es negativo y una secuencia de dígitos que van de 0 a 9 sin ceros iniciales. El signo negativo se define mediante el NumberFormatInfo objeto para la referencia cultural actual.
Para definir el formato de la representación de cadena del valor de byte firmado, llame al ToString(String) método .
Consulte también
- Aplicar formato a tipos en .NET
- Cadenas con formato numérico estándar
- Cadenas con formato numérico personalizado
Se aplica a
ToString(IFormatProvider)
- Source:
- SByte.cs
- Source:
- SByte.cs
- Source:
- SByte.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 -> string
Public Function ToString (provider As IFormatProvider) As String
Parámetros
- provider
- IFormatProvider
Objeto 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 define un objeto personalizado NumberFormatInfo y se asigna el carácter "~" a su NegativeSign propiedad . A continuación, en el ejemplo se usa este objeto personalizado, así como el NumberFormatInfo objeto de la referencia cultural invariable para dar formato a una serie de SByte valores.
using System;
using System.Globalization;
public class Example
{
public static void Main()
{
// Define a custom NumberFormatInfo object with "~" as its negative sign.
NumberFormatInfo nfi = new NumberFormatInfo();
nfi.NegativeSign = "~";
// Initialize an array of SByte values.
sbyte[] bytes = { -122, 17, 124 };
// Display the formatted result using the custom provider.
Console.WriteLine("Using the custom NumberFormatInfo object:");
foreach (sbyte value in bytes)
Console.WriteLine(value.ToString(nfi));
Console.WriteLine();
// Display the formatted result using the invariant culture.
Console.WriteLine("Using the invariant culture:");
foreach (sbyte value in bytes)
Console.WriteLine(value.ToString(NumberFormatInfo.InvariantInfo));
}
}
// The example displays the following output:
// Using the custom NumberFormatInfo object:
// ~122
// 17
// 124
//
// Using the invariant culture:
// -122
// 17
// 124
open System.Globalization
// Define a custom NumberFormatInfo object with "~" as its negative sign.
let nfi = NumberFormatInfo(NegativeSign = "~")
// Initialize an array of SByte values.
let bytes = [| -122y; 17y; 124y |]
// Display the formatted result using the custom provider.
printfn "Using the custom NumberFormatInfo object:"
for value in bytes do
printfn $"{value.ToString nfi}"
printfn ""
// Display the formatted result using the invariant culture.
printfn "Using the invariant culture:"
for value in bytes do
printfn $"{value.ToString NumberFormatInfo.InvariantInfo}"
// The example displays the following output:
// Using the custom NumberFormatInfo object:
// ~122
// 17
// 124
//
// Using the invariant culture:
// -122
// 17
// 124
Imports System.Globalization
Module Example
Public Sub Main()
' Define a custom NumberFormatInfo object with "~" as its negative sign.
Dim nfi As New NumberFormatInfo()
nfi.NegativeSign = "~"
' Initialize an array of SByte values.
Dim bytes() As SByte = { -122, 17, 124 }
' Display the formatted result using the custom provider.
Console.WriteLine("Using the custom NumberFormatInfo object:")
For Each value As SByte In bytes
Console.WriteLine(value.ToString(nfi))
Next
Console.WriteLine()
' Display the formatted result using the invariant culture.
Console.WriteLine("Using the invariant culture:")
For Each value As SByte In bytes
Console.WriteLine(value.ToString(NumberFormatInfo.InvariantInfo))
Next
End Sub
End Module
' The example displays the following output:
' Using the custom NumberFormatInfo object:
' ~122
' 17
' 124
'
' Using the invariant culture:
' -122
' 17
' 124
Comentarios
El ToString(IFormatProvider) método da formato a un SByte valor en el formato predeterminado ("G" o general) 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) |
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. Si provider
es null
, el SByte valor tiene el formato utilizando el NumberFormatInfo objeto de la referencia cultural actual. La única propiedad del NumberFormatInfo objeto que controla la representación de cadena del SByte valor mediante el especificador de formato general es NumberFormatInfo.NegativeSign, que define el carácter que representa el signo negativo.
El provider
parámetro puede ser uno de los siguientes:
Objeto CultureInfo que representa la referencia cultural que proporciona información de formato.
Objeto NumberFormatInfo que proporciona información de formato.
Objeto personalizado que implementa IFormatProvider. Su GetFormat método devuelve el NumberFormatInfo objeto que proporciona información de formato.
Consulte también
- Aplicar formato a tipos en .NET
- Cadenas con formato numérico estándar
- Cadenas con formato numérico personalizado
Se aplica a
ToString(String)
- Source:
- SByte.cs
- Source:
- SByte.cs
- Source:
- SByte.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 -> string
Public Function ToString (format As String) As String
Parámetros
- format
- String
Cadena de formato numérico estándar o personalizada.
Devoluciones
Representación en forma de cadena del valor de esta instancia, tal y como especifica format
.
Excepciones
format
no es válido.
Ejemplos
En el ejemplo siguiente se inicializa una matriz de SByte valores y se muestran mediante cada cadena de formato estándar y algunas cadenas de formato personalizado.
using System;
using System.Globalization;
public class Example
{
public static void Main()
{
sbyte[] values = { -124, 0, 118 };
string[] specifiers = { "G", "C", "D3", "E2", "e3", "F",
"N", "P", "X", "00.0", "#.0",
"000;(0);**Zero**" };
foreach (sbyte value in values)
{
foreach (string specifier in specifiers)
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
Console.WriteLine();
}
}
}
// The example displays the following output:
// G: -124
// C: ($124.00)
// D3: -124
// E2: -1.24E+002
// e3: -1.240e+002
// F: -124.00
// N: -124.00
// P: -12,400.00 %
// X: 84
// 00.0: -124.0
// #.0: -124.0
// 000;(0);**Zero**: (124)
//
// G: 0
// C: $0.00
// D3: 000
// E2: 0.00E+000
// e3: 0.000e+000
// F: 0.00
// N: 0.00
// P: 0.00 %
// X: 0
// 00.0: 00.0
// #.0: .0
// 000;(0);**Zero**: **Zero**
//
// G: 118
// C: $118.00
// D3: 118
// E2: 1.18E+002
// e3: 1.180e+002
// F: 118.00
// N: 118.00
// P: 11,800.00 %
// X: 76
// 00.0: 118.0
// #.0: 118.0
// 000;(0);**Zero**: 118
let values = [| -124y; 0y; 118y |]
let specifiers =
[| "G"; "C"; "D3"; "E2"; "e3"; "F"
"N"; "P"; "X"; "00.0"; "#.0"
"000(0)**Zero**" |]
for value in values do
for specifier in specifiers do
printfn $"{specifier}: {value.ToString specifier}"
printfn ""
// The example displays the following output:
// G: -124
// C: ($124.00)
// D3: -124
// E2: -1.24E+002
// e3: -1.240e+002
// F: -124.00
// N: -124.00
// P: -12,400.00 %
// X: 84
// 00.0: -124.0
// #.0: -124.0
// 000(0)**Zero**: (124)
//
// G: 0
// C: $0.00
// D3: 000
// E2: 0.00E+000
// e3: 0.000e+000
// F: 0.00
// N: 0.00
// P: 0.00 %
// X: 0
// 00.0: 00.0
// #.0: .0
// 000(0)**Zero**: **Zero**
//
// G: 118
// C: $118.00
// D3: 118
// E2: 1.18E+002
// e3: 1.180e+002
// F: 118.00
// N: 118.00
// P: 11,800.00 %
// X: 76
// 00.0: 118.0
// #.0: 118.0
// 000(0)**Zero**: 118
Imports System.Globalization
Module Example
Public Sub Main()
Dim values() As SByte = { -124, 0, 118 }
Dim specifiers() As String = { "G", "C", "D3", "E2", "e3", "F", _
"N", "P", "X", "00.0", "#.0", _
"000;(0);**Zero**" }
For Each value As SByte In values
For Each specifier As String In specifiers
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
Next
Console.WriteLine()
Next
End Sub
End Module
' The example displays the following output:
' G: -124
' C: ($124.00)
' D3: -124
' E2: -1.24E+002
' e3: -1.240e+002
' F: -124.00
' N: -124.00
' P: -12,400.00 %
' X: 84
' 00.0: -124.0
' #.0: -124.0
' 000;(0);**Zero**: (124)
'
' G: 0
' C: $0.00
' D3: 000
' E2: 0.00E+000
' e3: 0.000e+000
' F: 0.00
' N: 0.00
' P: 0.00 %
' X: 0
' 00.0: 00.0
' #.0: .0
' 000;(0);**Zero**: **Zero**
'
' G: 118
' C: $118.00
' D3: 118
' E2: 1.18E+002
' e3: 1.180e+002
' F: 118.00
' N: 118.00
' P: 11,800.00 %
' X: 76
' 00.0: 118.0
' #.0: 118.0
' 000;(0);**Zero**: 118
Comentarios
El ToString(String) método da formato a un SByte valor en un formato especificado mediante 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 cualquier especificador de formato numérico estándar válido o cualquier combinación de especificadores de formato numérico personalizado. Si format
es igual a String.Empty o es null
, el valor devuelto del objeto actual SByte tiene el formato del especificador de formato general ("G"). Si format
es cualquier otro valor, el método produce un FormatException.
.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 la compatibilidad con el formato en .NET, vea Formato de tipos.
El formato de la cadena devuelta viene determinado por el NumberFormatInfo objeto de la referencia cultural actual. Dependiendo del format
parámetro , este objeto controla símbolos como el signo negativo, el separador de grupo y el símbolo de separador decimal en la cadena de salida. Para proporcionar información de formato para referencias culturales distintas de la referencia cultural actual, llame a la ToString(String, IFormatProvider) sobrecarga.
Consulte también
- Aplicar formato a tipos en .NET
- Cómo: Rellenar un número con ceros a la izquierda
- Cadenas con formato numérico estándar
- Cadenas con formato numérico personalizado
Se aplica a
ToString(String, IFormatProvider)
- Source:
- SByte.cs
- Source:
- SByte.cs
- Source:
- SByte.cs
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.
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 -> string
Public Function ToString (format As String, provider As IFormatProvider) As String
Parámetros
- format
- String
Cadena de formato numérico estándar o personalizada.
- 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
Excepciones
format
no es válido.
Ejemplos
En el ejemplo siguiente se muestra un valor positivo y negativo SByte mediante los especificadores de formato numérico estándar y una serie de objetos específicos CultureInfo .
using System;
using System.Globalization;
public class Example
{
public static void Main()
{
// Define cultures whose formatting conventions are to be used.
CultureInfo[] cultures = { CultureInfo.CreateSpecificCulture("en-US"),
CultureInfo.CreateSpecificCulture("fr-FR"),
CultureInfo.CreateSpecificCulture("es-ES") };
sbyte positiveNumber = 119;
sbyte negativeNumber = -45;
string[] specifiers = {"G", "C", "D4", "E2", "F", "N", "P", "X2"};
foreach (string specifier in specifiers)
{
foreach (CultureInfo culture in cultures)
Console.WriteLine("{0,2} 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: 119 -45
// G format using fr-FR culture: 119 -45
// G format using es-ES culture: 119 -45
//
// C format using en-US culture: $119.00 ($45.00)
// C format using fr-FR culture: 119,00 € -45,00 €
// C format using es-ES culture: 119,00 € -45,00 €
//
// D4 format using en-US culture: 0119 -0045
// D4 format using fr-FR culture: 0119 -0045
// D4 format using es-ES culture: 0119 -0045
//
// E2 format using en-US culture: 1.19E+002 -4.50E+001
// E2 format using fr-FR culture: 1,19E+002 -4,50E+001
// E2 format using es-ES culture: 1,19E+002 -4,50E+001
//
// F format using en-US culture: 119.00 -45.00
// F format using fr-FR culture: 119,00 -45,00
// F format using es-ES culture: 119,00 -45,00
//
// N format using en-US culture: 119.00 -45.00
// N format using fr-FR culture: 119,00 -45,00
// N format using es-ES culture: 119,00 -45,00
//
// P format using en-US culture: 11,900.00 % -4,500.00 %
// P format using fr-FR culture: 11 900,00 % -4 500,00 %
// P format using es-ES culture: 11.900,00 % -4.500,00 %
//
// X2 format using en-US culture: 77 D3
// X2 format using fr-FR culture: 77 D3
// X2 format using es-ES culture: 77 D3
open System.Globalization
// Define cultures whose formatting conventions are to be used.
let cultures =
[| CultureInfo.CreateSpecificCulture "en-US"
CultureInfo.CreateSpecificCulture "fr-FR"
CultureInfo.CreateSpecificCulture "es-ES" |]
let positiveNumber = 119y
let negativeNumber = -45y
let specifiers = [| "G"; "C"; "D4"; "E2"; "F"; "N"; "P"; "X2" |]
for specifier in specifiers do
for culture in cultures do
printfn $"{specifier,2} format using {culture.Name} culture: {positiveNumber.ToString(specifier, culture), 16} {negativeNumber.ToString(specifier, culture), 16}"
printfn ""
// The example displays the following output:
// G format using en-US culture: 119 -45
// G format using fr-FR culture: 119 -45
// G format using es-ES culture: 119 -45
//
// C format using en-US culture: $119.00 ($45.00)
// C format using fr-FR culture: 119,00 € -45,00 €
// C format using es-ES culture: 119,00 € -45,00 €
//
// D4 format using en-US culture: 0119 -0045
// D4 format using fr-FR culture: 0119 -0045
// D4 format using es-ES culture: 0119 -0045
//
// E2 format using en-US culture: 1.19E+002 -4.50E+001
// E2 format using fr-FR culture: 1,19E+002 -4,50E+001
// E2 format using es-ES culture: 1,19E+002 -4,50E+001
//
// F format using en-US culture: 119.00 -45.00
// F format using fr-FR culture: 119,00 -45,00
// F format using es-ES culture: 119,00 -45,00
//
// N format using en-US culture: 119.00 -45.00
// N format using fr-FR culture: 119,00 -45,00
// N format using es-ES culture: 119,00 -45,00
//
// P format using en-US culture: 11,900.00 % -4,500.00 %
// P format using fr-FR culture: 11 900,00 % -4 500,00 %
// P format using es-ES culture: 11.900,00 % -4.500,00 %
//
// X2 format using en-US culture: 77 D3
// X2 format using fr-FR culture: 77 D3
// X2 format using es-ES culture: 77 D3
Imports System.Globalization
Module Example
Public Sub Main()
' Define cultures whose formatting conventions are to be used.
Dim cultures() As CultureInfo = {CultureInfo.CreateSpecificCulture("en-US"), _
CultureInfo.CreateSpecificCulture("fr-FR"), _
CultureInfo.CreateSpecificCulture("es-ES") }
Dim positiveNumber As SByte = 119
Dim negativeNumber As SByte = -45
Dim specifiers() As String = {"G", "C", "D4", "E2", "F", "N", "P", "X2"}
For Each specifier As String In specifiers
For Each culture As CultureInfo In Cultures
Console.WriteLine("{0,2} format using {1} culture: {2, 16} {3, 16}", _
specifier, culture.Name, _
positiveNumber.ToString(specifier, culture), _
negativeNumber.ToString(specifier, culture))
Next
Console.WriteLine()
Next
End Sub
End Module
' The example displays the following output:
' G format using en-US culture: 119 -45
' G format using fr-FR culture: 119 -45
' G format using es-ES culture: 119 -45
'
' C format using en-US culture: $119.00 ($45.00)
' C format using fr-FR culture: 119,00 € -45,00 €
' C format using es-ES culture: 119,00 € -45,00 €
'
' D4 format using en-US culture: 0119 -0045
' D4 format using fr-FR culture: 0119 -0045
' D4 format using es-ES culture: 0119 -0045
'
' E2 format using en-US culture: 1.19E+002 -4.50E+001
' E2 format using fr-FR culture: 1,19E+002 -4,50E+001
' E2 format using es-ES culture: 1,19E+002 -4,50E+001
'
' F format using en-US culture: 119.00 -45.00
' F format using fr-FR culture: 119,00 -45,00
' F format using es-ES culture: 119,00 -45,00
'
' N format using en-US culture: 119.00 -45.00
' N format using fr-FR culture: 119,00 -45,00
' N format using es-ES culture: 119,00 -45,00
'
' P format using en-US culture: 11,900.00 % -4,500.00 %
' P format using fr-FR culture: 11 900,00 % -4 500,00 %
' P format using es-ES culture: 11.900,00 % -4.500,00 %
'
' X2 format using en-US culture: 77 D3
' X2 format using fr-FR culture: 77 D3
' X2 format using es-ES culture: 77 D3
Comentarios
El ToString(String, IFormatProvider) método da formato a un SByte valor en un formato especificado 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 cualquier especificador de formato numérico estándar válido o cualquier combinación de especificadores de formato numérico personalizado. Si format
es igual a String.Empty o es null
, el valor devuelto del objeto actual SByte tiene el formato del especificador de formato general ("G"). Si format
es cualquier otro valor, el método produce un FormatException.
.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 la compatibilidad con el formato en .NET, vea Formato de tipos.
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. Cuando se invoca el ToString(String, IFormatProvider) método , llama al provider
método del IFormatProvider.GetFormat parámetro y lo pasa a un Type objeto que representa el NumberFormatInfo tipo. A GetFormat continuación, el método devuelve el NumberFormatInfo objeto que proporciona información para dar formato al value
parámetro, como el símbolo de signo negativo, el símbolo separador de grupo o el símbolo de punto decimal. Hay tres maneras de usar el provider
parámetro para proporcionar información de formato al ToString(String, IFormatProvider) método :
Puede pasar un CultureInfo objeto que represente la referencia cultural que proporciona información de formato. Su GetFormat método devuelve el NumberFormatInfo objeto que proporciona información de formato numérico para esa referencia cultural.
Puede pasar el objeto real NumberFormatInfo que proporciona información de formato numérico. (Su implementación de GetFormat simplemente devuelve a sí mismo).
Puede pasar un objeto personalizado que implemente IFormatProvider. Su GetFormat método crea una instancia y devuelve el NumberFormatInfo objeto que proporciona información de formato.
Si provider
es null
, el formato de la cadena devuelta se basa en el NumberFormatInfo objeto de la referencia cultural actual.
Consulte también
- Aplicar formato a tipos en .NET
- Cómo: Rellenar un número con ceros a la izquierda
- Cadenas con formato numérico estándar
- Cadenas con formato numérico personalizado
- Ejemplo: Utilidad de formato WinForms de .NET Core (C#)
- Ejemplo: Utilidad de formato WinForms de .NET Core (Visual Basic)