Int32.ToString Int32.ToString Int32.ToString Int32.ToString Method

Definición

Convierte el valor numérico de esta instancia en la representación de cadena equivalente.Converts the numeric value of this instance to its equivalent string representation.

Sobrecargas

ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider) 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.Converts the numeric value of this instance to its equivalent string representation using the specified culture-specific format information.

ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider) 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.Converts the numeric value of this instance to its equivalent string representation using the specified format and culture-specific format information.

ToString(String) ToString(String) ToString(String) ToString(String)

Convierte el valor numérico de esta instancia en la representación de cadena equivalente usando el formato especificado.Converts the numeric value of this instance to its equivalent string representation, using the specified format.

ToString() ToString() ToString() ToString()

Convierte el valor numérico de esta instancia en la representación de cadena equivalente.Converts the numeric value of this instance to its equivalent string representation.

ToString(IFormatProvider) ToString(IFormatProvider) ToString(IFormatProvider) 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.Converts the numeric value of this instance to its equivalent string representation using the specified culture-specific format information.

public:
 virtual System::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 IFormatProvider IFormatProvider IFormatProvider

Objeto que proporciona información de formato específica de la referencia cultural.An object that supplies culture-specific formatting information.

Devoluciones

Representación en forma de cadena del valor de esta instancia, tal y como especifica provider.The string representation of the value of this instance as specified by provider.

Implementaciones

Ejemplos

En el ejemplo siguiente se muestra la representación de cadena de un Int32 valor mediante CultureInfo objetos que representan varias referencias culturales diferentes.The following example displays the string representation of an Int32 value using CultureInfo objects that represent several different cultures.

using namespace System;
using namespace System::Globalization;

void main()
{
    int value = -16325;
    // 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")));
}
// The example displays the following output:
//       -16325
//       -16325
//       -16325
int value = -16325;
// 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
//       -16325
//       -16325
Dim value As Integer = -16325
' 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
'       -16325
'       -16325

Comentarios

El ToString(IFormatProvider) método formatos un Int32 valor en el valor predeterminado ("G" o general) formato mediante el uso de la NumberFormatInfo objeto de una referencia cultural especificada.The ToString(IFormatProvider) method formats an Int32 value in the default ("G", or general) format by using the NumberFormatInfo object of a specified culture. Si desea especificar un formato diferente o la referencia cultural actual, use las otras sobrecargas de los ToString método, como se indica a continuación:If you want to specify a different format or the current culture, use the other overloads of the ToString method, as follows:

Para usar el formatoTo use format Para la referencia culturalFor culture Use la sobrecargaUse the overload
Formato predeterminado ("G")Default ("G") format Referencia cultural de forma predeterminada (actual)Default (current) culture ToString()
Un formato concretoA specific format Referencia cultural de forma predeterminada (actual)Default (current) culture ToString(String)
Un formato concretoA specific format Una referencia cultural específicaA specific culture ToString(String, IFormatProvider)

El provider parámetro es un objeto que implementa el IFormatProvider interfaz.The provider parameter is an object that implements the IFormatProvider interface. 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.Its GetFormat method returns a NumberFormatInfo object that provides culture-specific information about the format of the string that is returned by this method. El objeto que implementa IFormatProvider puede ser cualquiera de las siguientes acciones:The object that implements IFormatProvider can be any of the following:

  • Un CultureInfo objeto que representa la referencia cultural cuyas reglas de formato que se van a utilizar.A CultureInfo object that represents the culture whose formatting rules are to be used.

  • Un NumberFormatInfo objeto que contiene información de formato numérico específico para este valor.A NumberFormatInfo object that contains specific numeric formatting information for this value.

  • Un objeto personalizado que implementa IFormatProvider y cuyo GetFormat método devuelve un NumberFormatInfo objeto que proporciona información de formato.A custom object that implements IFormatProvider and whose GetFormat method returns a NumberFormatInfo object that provides formatting information.

Si provider es null o un NumberFormatInfo objeto no se puede obtener desde provider, el valor devuelto se representa con la NumberFormatInfo objeto para la referencia cultural del subproceso actual.If provider is null or a NumberFormatInfo object cannot be obtained from provider, the return value is formatted using the NumberFormatInfo object for the thread current culture. Para obtener información acerca de la referencia cultural del subproceso actual, vea Thread.CurrentCulture.For information about the thread current culture, see Thread.CurrentCulture.

.NET Framework proporciona una amplia compatibilidad de formato, que se describe con más detalle en los temas de formato siguientes:The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

Consulte también:

ToString(String, IFormatProvider) ToString(String, IFormatProvider) ToString(String, IFormatProvider) 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.Converts the numeric value of this instance to its equivalent string representation using the specified format and culture-specific format information.

public:
 virtual System::String ^ ToString(System::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 String String String

Cadena de formato numérico estándar o personalizada.A standard or custom numeric format string.

provider
IFormatProvider IFormatProvider IFormatProvider IFormatProvider

Objeto que proporciona información de formato específica de la referencia cultural.An object that supplies culture-specific formatting information.

Devoluciones

Representación de cadena del valor de esta instancia, tal y como especifican format y provider.The string representation of the value of this instance as specified by format and provider.

Implementaciones

Excepciones

format no es válido o no se admite.format is invalid or not supported.

Ejemplos

En el ejemplo siguiente se muestra un valor positivo y negativo con cada uno de los especificadores de formato numérico estándar compatibles para tres referencias culturales diferentes.The following example displays a positive and a negative value using each of the supported standard numeric format specifiers for three different cultures.

using namespace System;
using namespace System::Globalization;

void main()
{
    // Define cultures whose formatting conventions are to be used.
    array<CultureInfo^>^ cultures = { CultureInfo::CreateSpecificCulture("en-US"), 
                                      CultureInfo::CreateSpecificCulture("fr-FR"), 
                                      CultureInfo::CreateSpecificCulture("es-ES") };
    int positiveNumber = 1679;
    int negativeNumber = -3045;
    array<String^>^ specifiers = {"G", "C", "D8", "E2", "F", "N", "P", "X8"}; 
    
    for each (String^ specifier in specifiers)
    {
       for each (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
// 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
' 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 Integer = 1679
Dim negativeNumber As Integer = -3045
Dim specifiers() As String = {"G", "C", "D8", "E2", "F", "N", "P", "X8"} 

For Each specifier As String In specifiers
   For Each culture As CultureInfo 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))

   Next
   Console.WriteLine()
Next
' The example displays the following output to the console:
'       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

Comentarios

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.The ToString(String, IFormatProvider) method formats an Int32 value in a specified format by using the NumberFormatInfo object of a specified culture. Si desea utilizar la configuración de formato o la referencia cultural predeterminada, use las otras sobrecargas de los ToString método, como se indica a continuación:If you want to use default format or culture settings, use the other overloads of the ToString method, as follows:

Para usar el formatoTo use format Para la referencia culturalFor culture Use la sobrecargaUse the overload
Formato predeterminado ("G")Default ("G") format Referencia cultural de forma predeterminada (actual)Default (current) culture ToString()
Formato predeterminado ("G")Default ("G") format Una referencia cultural específicaA specific culture ToString(IFormatProvider)
Un formato concretoA specific format Referencia cultural de forma predeterminada (actual)Default (current) culture ToString(String)

El format parámetro puede ser un estándar o una cadena de formato numérico personalizado.The format parameter can be either a standard or a custom numeric format string. Se admiten todas las cadenas de formato numérico estándar que no sea "R" (o "r"), como los todos los caracteres de formato numérico personalizado.All standard numeric format strings other than "R" (or "r") are supported, as are all custom numeric format characters. Si format es null o una cadena vacía (""), el valor devuelto para esta instancia se formatea con el especificador de formato numérico general ("G").If format is null or an empty string (""), the return value for this instance is formatted with the general numeric format specifier ("G").

El provider parámetro es un objeto que implementa el IFormatProvider interfaz.The provider parameter is an object that implements the IFormatProvider interface. 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.Its GetFormat method returns a NumberFormatInfo object that provides culture-specific format information about the format of the string that is returned by this method. El objeto que implementa IFormatProvider puede ser cualquiera de las siguientes acciones:The object that implements IFormatProvider can be any of the following:

  • Un CultureInfo objeto que representa la referencia cultural cuyas reglas de formato que se van a utilizar.A CultureInfo object that represents the culture whose formatting rules are to be used.

  • Un NumberFormatInfo objeto que contiene información de formato numérico específico para este valor.A NumberFormatInfo object that contains specific numeric formatting information for this value.

  • Un objeto personalizado que implementa IFormatProvider y cuyo GetFormat método devuelve un NumberFormatInfo objeto que proporciona información de formato.A custom object that implements IFormatProvider and whose GetFormat method returns a NumberFormatInfo object that provides formatting information.

Si provider es null o un NumberFormatInfo objeto no se puede obtener desde provider, el valor devuelto para esta instancia se formatea con el NumberFormatInfo para la referencia cultural actual.If provider is null or a NumberFormatInfo object cannot be obtained from provider, the return value for this instance is formatted with the NumberFormatInfo for the current culture.

.NET Framework proporciona una amplia compatibilidad de formato, que se describe con más detalle en los temas de formato siguientes:The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

Consulte también:

ToString(String) ToString(String) ToString(String) ToString(String)

Convierte el valor numérico de esta instancia en la representación de cadena equivalente usando el formato especificado.Converts the numeric value of this instance to its equivalent string representation, using the specified format.

public:
 System::String ^ ToString(System::String ^ format);
public string ToString (string format);
override this.ToString : string -> string
Public Function ToString (format As String) As String

Parámetros

format
String String String String

Cadena de formato numérico estándar o personalizada.A standard or custom numeric format string.

Devoluciones

Representación en forma de cadena del valor de esta instancia, tal y como especifica format.The string representation of the value of this instance as specified by format.

Excepciones

format no es válido o no se admite.format is invalid or not supported.

Ejemplos

El ejemplo siguiente se muestra un Int32 valor con cada uno de los especificadores de formato numérico estándar compatibles, junto con dos cadenas de formato numérico personalizado.The following example displays an Int32 value using each of the supported standard numeric format specifiers, together with two custom numeric format strings. Convertir los valores numéricos en cadenas, el ejemplo usa las convenciones de formato de la referencia cultural en-US.In converting the numeric values to strings, the example uses the formatting conventions of the en-US culture.

using namespace System;

void main()
{
    int value = -16325;
    String^ specifier;
    
    // Use standard numeric format specifiers.
    specifier = "G";
    Console::WriteLine("{0}: {1}", specifier, value.ToString(specifier));

    specifier = "C";
    Console::WriteLine("{0}: {1}", specifier, value.ToString(specifier));

    specifier = "D8";
    Console::WriteLine("{0}: {1}", specifier, value.ToString(specifier));

    specifier = "E4";
    Console::WriteLine("{0}: {1}", specifier, value.ToString(specifier));

    specifier = "e3";
    Console::WriteLine("{0}: {1}", specifier, value.ToString(specifier));

    specifier = "F";
    Console::WriteLine("{0}: {1}", specifier, value.ToString(specifier));

    specifier = "N";
    Console::WriteLine("{0}: {1}", specifier, value.ToString(specifier));

    specifier = "P";
    Console::WriteLine("{0}: {1}", specifier, (value/100000).ToString(specifier));

    specifier = "X";
    Console::WriteLine("{0}: {1}", specifier, value.ToString(specifier));
    
    // Use custom numeric format specifiers.
    specifier = "0,0.000";
    Console::WriteLine("{0}: {1}", specifier, value.ToString(specifier));

    specifier = "#,#.00#;(#,#.00#)";
    Console::WriteLine("{0}: {1}", specifier, (value*-1).ToString(specifier));
}   
// The example displays the following output:
//     G: -16325
//     C: ($16,325.00)
//     D8: -00016325
//     E4: -1.6325E+004
//     e3: -1.633e+004
//     F: -16325.00
//     N: -16,325.00
//     P: 0.00 %
//     X: FFFFC03B
//     0,0.000: -16,325.000
//     #,#.00#;(#,#.00#): 16,325.00
int value = -16325;
string specifier;

// Use standard numeric format specifier.
specifier = "G";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    G: -16325
specifier = "C";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    C: ($16,325.00)
specifier = "D8";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    D8: -00016325
specifier = "E4";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    E4: -1.6325E+004
specifier = "e3";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    e3: -1.633e+004
specifier = "F";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    F: -16325.00
specifier = "N";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    N: -16,325.00
specifier = "P";
Console.WriteLine("{0}: {1}", specifier, (value/100000).ToString(specifier));
// Displays:    P: -16.33 %
specifier = "X";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    X: FFFFC03B 

// Use custom numeric format specifiers.
specifier = "0,0.000";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    0,0.000: -16,325.000
specifier = "#,#.00#;(#,#.00#)";
Console.WriteLine("{0}: {1}", specifier, (value*-1).ToString(specifier));
// Displays:    #,#.00#;(#,#.00#): 16,325.00
Dim value As Integer = -16325
Dim specifier As String

' Use standard numeric format specifier.
specifier = "G"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays:    G: -16325
specifier = "C"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays:    C: ($16,325.00)
specifier = "D8"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays:    D8: -00016325
specifier = "E4"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays:    E4: -1.6325E+004
specifier = "e3"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays:    e3: -1.633e+004
specifier = "F"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays:    F: -16325.00
specifier = "N"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays:    N: -16,325.00
specifier = "P"
Console.WriteLine("{0}: {1}", specifier, (value/100000).ToString(specifier))
' Displays:    P: -16.33 %
specifier = "X"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays:    X: FFFFC03B 

' Use custom numeric format specifiers.
specifier = "0,0.000"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays:    0,0.000: -16,325.000
specifier = "#,#.00#;(#,#.00#)"
Console.WriteLine("{0}: {1}", specifier, (value*-1).ToString(specifier))
' Displays:    #,#.00#;(#,#.00#): 16,325.00

Comentarios

El ToString(String) método formatos un Int32 valor en un formato especificado mediante el uso de un NumberFormatInfo objeto que representa las convenciones de la referencia cultural actual.The ToString(String) method formats an Int32 value in a specified format by using a NumberFormatInfo object that represents the conventions of the current culture. Si desea usar el valor predeterminado ("G" o general) dar formato o especificar una referencia cultural diferente, use las otras sobrecargas de los ToString método, como se indica a continuación:If you want to use the default ("G", or general) format or specify a different culture, use the other overloads of the ToString method, as follows:

Para usar el formatoTo use format Para la referencia culturalFor culture Use la sobrecargaUse the overload
Formato predeterminado ("G")Default ("G") format Referencia cultural de forma predeterminada (actual)Default (current) culture ToString()
Formato predeterminado ("G")Default ("G") format Una referencia cultural específicaA specific culture ToString(IFormatProvider)
Un formato concretoA specific format Una referencia cultural específicaA specific culture ToString(String, IFormatProvider)

El format parámetro puede ser cualquier especificador de formato numérico estándar válido salvo "R", así como cualquier combinación de especificadores de formato numérico personalizado.The format parameter can be any valid standard numeric format specifier except for "R", as well as any combination of custom numeric format specifiers. 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").If format is null or an empty string (""), the return value of this instance is formatted with the general numeric format specifier ("G").

.NET Framework proporciona una amplia compatibilidad de formato, que se describe con más detalle en los temas de formato siguientes:The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

El valor devuelto de esta instancia se formatea con el NumberFormatInfo para la referencia cultural actual.The return value of this instance is formatted with the NumberFormatInfo for the current culture.

Consulte también:

ToString() ToString() ToString() ToString()

Convierte el valor numérico de esta instancia en la representación de cadena equivalente.Converts the numeric value of this instance to its equivalent string representation.

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.The string representation of the value of this instance, consisting of a negative sign if the value is negative, and a sequence of digits ranging from 0 to 9 with no leading zeroes.

Ejemplos

El ejemplo siguiente se muestra un Int32 con el valor predeterminado de valor ToString() método.The following example displays an Int32 value using the default ToString() method. También muestra las representaciones de cadena de la Int32 valor que resulta de usar un número de especificadores de formato estándar.It also displays the string representations of the Int32 value that results from using a number of standard format specifiers. Los ejemplos se muestran utilizando las convenciones de formato de la referencia cultural en-US.The examples are displayed using the formatting conventions of the en-US culture.

using namespace System;

void main()
{
    int value = -16325;
    // Display value using default ToString method.
    Console::WriteLine(value.ToString());             
    // Display value using some standard format specifiers.
    Console::WriteLine(value.ToString("G"));         
    Console::WriteLine(value.ToString("C"));         
    Console::WriteLine(value.ToString("D"));         
    Console::WriteLine(value.ToString("F"));         
    Console::WriteLine(value.ToString("N"));         
    Console::WriteLine(value.ToString("X"));              
}
// The example displays the following output:
//     -16325
//     -16325
//     ($16,325.00)
//     -16325
//     -16325.00
//     -16,325.00
//     FFFFC03B
int value = -16325;
// Display value using default ToString method.
Console.WriteLine(value.ToString());            // Displays -16325
// Display value using some standard format specifiers.
Console.WriteLine(value.ToString("G"));         // Displays -16325
Console.WriteLine(value.ToString("C"));         // Displays ($16,325.00)
Console.WriteLine(value.ToString("D"));         // Displays -16325
Console.WriteLine(value.ToString("F"));         // Displays -16325.00
Console.WriteLine(value.ToString("N"));         // Displays -16,325.00
Console.WriteLine(value.ToString("X"));         // Displays FFFFC03B      
Dim value As Integer = -16325
' Display value using default ToString method.
Console.WriteLine(value.ToString())            ' Displays -16325
' Display value using some standard format specifiers.
Console.WriteLine(value.ToString("G"))         ' Displays -16325
Console.WriteLine(value.ToString("C"))         ' Displays ($16,325.00)
Console.WriteLine(value.ToString("D"))         ' Displays -16325
Console.WriteLine(value.ToString("F"))         ' Displays -16325.00
Console.WriteLine(value.ToString("N"))         ' Displays -16,325.00
Console.WriteLine(value.ToString("X"))         ' Displays FFFFC03B      

Comentarios

El ToString() método formatos un Int32 valor en el valor predeterminado ("G" o general) formato utilizando la NumberFormatInfo objeto de la referencia cultural actual.The ToString() method formats an Int32 value in the default ("G", or general) format by using the NumberFormatInfo object of the current culture. Si desea especificar un formato diferente o la referencia cultural, use las otras sobrecargas de los ToString método, como se indica a continuación:If you want to specify a different format or culture, use the other overloads of the ToString method, as follows:

Para usar el formatoTo use format Para la referencia culturalFor culture Use la sobrecargaUse the overload
Formato predeterminado ("G")Default ("G") format Una referencia cultural específicaA specific culture ToString(IFormatProvider)
Un formato concretoA specific format Referencia cultural de forma predeterminada (actual)Default (current) culture ToString(String)
Un formato concretoA specific format Una referencia cultural específicaA specific culture ToString(String, IFormatProvider)

.NET Framework proporciona una amplia compatibilidad de formato, que se describe con más detalle en los temas de formato siguientes:The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

Consulte también:

Se aplica a