Decimal.ToString Método

Definición

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

Sobrecargas

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)

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)

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()

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)

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:
 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

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 Decimal cadena de CultureInfo un valor mediante objetos que representan varias referencias culturales diferentes.The following example displays the string representation of a Decimal value using CultureInfo objects that represent several different cultures.

decimal value = -16325.62m;
// 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.62
//       -16325.62
//       -16325,62
Dim value As Decimal = -16325.62d
' 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.62
'       -16325.62
'       -16325,62

Comentarios

El ToString(IFormatProvider) método da formato Decimal a un valor en el formato predeterminado ("G" o general) de una referencia cultural especificada.The ToString(IFormatProvider) method formats a Decimal value in the default ("G", or general) format of a specified culture. Si desea especificar un formato diferente o la referencia cultural actual, use las otras sobrecargas del 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 Usar la sobrecargaUse the overload
Formato predeterminado ("G")Default ("G") format Referencia cultural predeterminada (actual)Default (current) culture ToString()
Un formato específicoA specific format Referencia cultural predeterminada (actual)Default (current) culture ToString(String)
Un formato específicoA specific format Una referencia cultural específicaA specific culture ToString(String, IFormatProvider)

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

El provider parámetro es una IFormatProvider implementación cuyo IFormatProvider.GetFormat método devuelve un NumberFormatInfo objeto.The provider parameter is an IFormatProvider implementation whose IFormatProvider.GetFormat method returns a NumberFormatInfo object. Normalmente, provider es un NumberFormatInfo objeto o un CultureInfo objeto.Typically, provider is a NumberFormatInfo object or a CultureInfo object. El provider parámetro proporciona información específica de la referencia cultural usada en el formato.The provider parameter supplies culture-specific information used in formatting. Si provider es null, se usa la referencia cultural actual del subproceso.If provider is null, the thread current culture is used.

Para convertir un Decimal valor en su representación de cadena mediante una referencia cultural especificada y una cadena de formato concreta Decimal.ToString(String, IFormatProvider) , llame al método.To convert a Decimal value to its string representation using a specified culture and a specific format string, call the Decimal.ToString(String, IFormatProvider) method.

Consulte también:

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

Cadena de formato numérico.A numeric format string.

provider
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.format is invalid.

Ejemplos

En el ejemplo siguiente se Decimal muestra un valor mediante cada uno de los especificadores de formato numérico estándar admitidos para varias referencias culturales diferentes.The following example displays a Decimal value using each of the supported standard numeric format specifiers for several different cultures.

decimal value = 16325.62m;
string specifier;
CultureInfo culture;

// Use standard numeric format specifiers.
specifier = "G";
culture = CultureInfo.CreateSpecificCulture("eu-ES");
Console.WriteLine(value.ToString(specifier, culture));
// Displays:    16325,62
Console.WriteLine(value.ToString(specifier, CultureInfo.InvariantCulture));
// Displays:    16325.62

specifier = "C";
culture = CultureInfo.CreateSpecificCulture("en-US");
Console.WriteLine(value.ToString(specifier, culture));
// Displays:    $16,325.62
culture = CultureInfo.CreateSpecificCulture("en-GB");
Console.WriteLine(value.ToString(specifier, culture));
// Displays:    £16,325.62

specifier = "E04";
culture = CultureInfo.CreateSpecificCulture("sv-SE");
Console.WriteLine(value.ToString(specifier, culture));
// Displays: 1,6326E+004   
 culture = CultureInfo.CreateSpecificCulture("en-NZ");
 Console.WriteLine(value.ToString(specifier, culture));
// Displays:    1.6326E+004   

specifier = "F";
culture = CultureInfo.CreateSpecificCulture("fr-FR");
Console.WriteLine(value.ToString(specifier, culture));
// Displays:    16325,62
culture = CultureInfo.CreateSpecificCulture("en-CA");
Console.WriteLine(value.ToString(specifier, culture));
// Displays:    16325.62

specifier = "N";
culture = CultureInfo.CreateSpecificCulture("es-ES");
Console.WriteLine(value.ToString(specifier, culture));
// Displays:    16.325,62
culture = CultureInfo.CreateSpecificCulture("fr-CA");
Console.WriteLine(value.ToString(specifier, culture));
// Displays:    16 325,62

specifier = "P";
culture = CultureInfo.InvariantCulture;
Console.WriteLine((value/10000).ToString(specifier, culture));
// Displays:    163.26 %
culture = CultureInfo.CreateSpecificCulture("ar-EG");
Console.WriteLine((value/10000).ToString(specifier, culture));
// Displays:    163.256 %
Dim value As Decimal = 16325.62d
Dim specifier As String
Dim culture As CultureInfo

' Use standard numeric format specifiers.
specifier = "G"
culture = CultureInfo.CreateSpecificCulture("eu-ES")
Console.WriteLine(value.ToString(specifier, culture))
' Displays:    16325,62
Console.WriteLine(value.ToString(specifier, CultureInfo.InvariantCulture))
' Displays:    16325.62

specifier = "C"
culture = CultureInfo.CreateSpecificCulture("en-US")
Console.WriteLine(value.ToString(specifier, culture))
' Displays:    $16,325.62
culture = CultureInfo.CreateSpecificCulture("en-GB")
Console.WriteLine(value.ToString(specifier, culture))
' Displays:    £16,325.62

specifier = "E04"
culture = CultureInfo.CreateSpecificCulture("sv-SE")
Console.WriteLine(value.ToString(specifier, culture))
' Displays: 1,6326E+004   
 culture = CultureInfo.CreateSpecificCulture("en-NZ")
 Console.WriteLine(value.ToString(specifier, culture))
' Displays:    1.6326E+004   

specifier = "F"
culture = CultureInfo.CreateSpecificCulture("fr-FR")
Console.WriteLine(value.ToString(specifier, culture))
' Displays:    16325,62
culture = CultureInfo.CreateSpecificCulture("en-CA")
Console.WriteLine(value.ToString(specifier, culture))
' Displays:    16325.62

specifier = "N"
culture = CultureInfo.CreateSpecificCulture("es-ES")
Console.WriteLine(value.ToString(specifier, culture))
' Displays:    16.325,62
culture = CultureInfo.CreateSpecificCulture("fr-CA")
Console.WriteLine(value.ToString(specifier, culture))
' Displays:    16 325,62

specifier = "P"
culture = CultureInfo.InvariantCulture
Console.WriteLine((value/10000).ToString(specifier, culture))
' Displays:    163.26 %
culture = CultureInfo.CreateSpecificCulture("ar-EG")
Console.WriteLine((value/10000).ToString(specifier, culture))
' Displays:    163.256 %

Comentarios

El ToString(String, IFormatProvider) método da formato Decimal a un valor en un formato especificado de una referencia cultural especificada.The ToString(String, IFormatProvider) method formats a Decimal value in a specified format of a specified culture. Si desea utilizar el formato predeterminado o la configuración de referencia cultural, utilice las otras sobrecargas ToString del 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 Usar la sobrecargaUse the overload
Formato predeterminado ("G")Default ("G") format Referencia cultural predeterminada (actual)Default (current) culture ToString()
Formato predeterminado ("G")Default ("G") format Una referencia cultural específicaA specific culture ToString(IFormatProvider)
Un formato específicoA specific format Referencia cultural predeterminada (actual)Default (current) culture ToString(String)

El format parámetro puede ser cualquier especificador de formato numérico estándar válido, excepto D, R y X, 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 D, R, and X, as well as any combination of custom numeric format specifiers. Si format esnull o una cadena vacía, el valor devuelto para esta instancia tiene el formato del 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 .NET Framework proporciona una amplia compatibilidad con el formato, que se describe con más detalle en los siguientes temas de formato:The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

El provider parámetro es una IFormatProvider implementación cuyo IFormatProvider.GetFormat método devuelve un NumberFormatInfo objeto.The provider parameter is an IFormatProvider implementation whose IFormatProvider.GetFormat method returns a NumberFormatInfo object. Normalmente, provider es un NumberFormatInfo objeto CultureInfo o.Typically, provider is a NumberFormatInfo or CultureInfo object. El provider parámetro proporciona información específica de la referencia cultural usada en el formato.The provider parameter supplies culture-specific information used in formatting. Si provider es null, se usa la referencia cultural actual del subproceso.If provider is null, the thread current culture is used.

Consulte también:

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

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.format is invalid.

Ejemplos

En el ejemplo siguiente se Decimal muestra un valor mediante cada uno de los especificadores de formato numérico estándar admitidos, junto con dos cadenas de formato numérico personalizado.The following example displays a Decimal value using each of the supported standard numeric format specifiers, together with two custom numeric format strings. Al convertir los valores numéricos en cadenas, en el ejemplo se usan 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.

decimal value = 16325.62m;
string specifier;

// Use standard numeric format specifiers.
specifier = "G";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    G: 16325.62
specifier = "C";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    C: $16,325.62
specifier = "E04";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    E04: 1.6326E+004
specifier = "F";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    F: 16325.62
specifier = "N";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    N: 16,325.62
specifier = "P";
Console.WriteLine("{0}: {1}", specifier, (value/10000).ToString(specifier));
// Displays:    P: 163.26 %

// Use custom numeric format specifiers.
specifier = "0,0.000";
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier));
// Displays:    0,0.000: 16,325.620
specifier = "#,#.00#;(#,#.00#)";
Console.WriteLine("{0}: {1}", specifier, (value*-1).ToString(specifier));
// Displays:    #,#.00#;(#,#.00#): (16,325.62)
Dim value As Decimal = 16325.62d
Dim specifier As String

' Use standard numeric format specifiers.
specifier = "G"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays:    G: 16325.62
specifier = "C"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays:    C: $16,325.62
specifier = "E04"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays:    E04: 1.6326E+004
specifier = "F"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays:    F: 16325.62
specifier = "N"
Console.WriteLine("{0}: {1}", specifier, value.ToString(specifier))
' Displays:    N: 16,325.62
specifier = "P"
Console.WriteLine("{0}: {1}", specifier, (value/10000).ToString(specifier))
' Displays:    P: 163.26 %

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

Comentarios

El ToString(String) método da formato Decimal a un valor en un formato especificado mediante las convenciones de la referencia cultural actual.The ToString(String) method formats a Decimal value in a specified format by using the conventions of the current culture. Si desea utilizar el formato predeterminado ("G" o general) o especificar una referencia cultural diferente, use las otras sobrecargas del 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 Usar la sobrecargaUse the overload
Formato predeterminado ("G")Default ("G") format Referencia cultural predeterminada (actual)Default (current) culture ToString()
Formato predeterminado ("G")Default ("G") format Una referencia cultural específicaA specific culture ToString(IFormatProvider)
Un formato específicoA specific format Una referencia cultural específicaA specific culture ToString(String, IFormatProvider)

El ToString método utiliza la cadena de formato numérico estándar o personalizada que especifica format el parámetro para convertir el valor de la instancia actual en su representación de cadena.The ToString method uses the standard or custom numeric format string specified by the format parameter to convert the value of the current instance into its string representation. El format parámetro puede ser cualquier especificador de formato numérico estándar válido, excepto D, R y X, 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 D, R, and X, as well as any combination of custom numeric format specifiers. Si format esnull 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).

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

El valor devuelto se formatea utilizando el NumberFormatInfo objeto para la referencia cultural actual.The return value is formatted by using the NumberFormatInfo object for the current culture. Para aplicar las convenciones de formato de una referencia cultural especificada, ToString(String, IFormatProvider) llame al método.To apply the formatting conventions of a specified culture, call the ToString(String, IFormatProvider) method.

Consulte también:

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

Cadena que representa el valor de esta instancia.A string that represents the value of this instance.

Ejemplos

En el ejemplo siguiente se Decimal muestra un valor mediante ToString() el método predeterminado.The following example displays a Decimal value using the default ToString() method. También muestra las representaciones de cadena del Decimal valor resultante de usar un número de especificadores de formato estándar.It also displays the string representations of the Decimal value that result from using a number of standard format specifiers.

decimal value = -16325.62m;
// Display value using default ToString method.
Console.WriteLine(value.ToString());            // Displays -16325.62
// Display value using some standard format specifiers.
Console.WriteLine(value.ToString("G"));         // Displays -16325.62
Console.WriteLine(value.ToString("C"));         // Displays ($16,325.62)
Console.WriteLine(value.ToString("F"));         // Displays -16325.62      
Dim value As Decimal = -16325.62d
' Display value using default ToString method.
Console.WriteLine(value.ToString())            ' Displays -16325.62
' Display value using some standard format specifiers.
Console.WriteLine(value.ToString("G"))         ' Displays -16325.62
Console.WriteLine(value.ToString("C"))         ' Displays ($16,325.62)
Console.WriteLine(value.ToString("F"))         ' Displays -16325.62      

En el ejemplo siguiente se muestra la cantidad de dinero de una cuenta.The following example displays the amount of money in an account.

   public ref class PiggyBank
   {
   public:
      void AddPenny()
      {
         MyFortune = Decimal::Add( MyFortune, (Decimal).01 );
      }

      virtual System::String^ ToString() override
      {
         return MyFortune.ToString("C")+" in piggy bank";
      }

   protected:
      Decimal MyFortune;
   };
}
class PiggyBank {
    public void AddPenny() {
        MyFortune = Decimal.Add(MyFortune, .01m);
    }

    public override string ToString() {
        return MyFortune.ToString("C")+" in piggy bank";
    }

    protected decimal MyFortune;
}
Class PiggyBank

    Public Sub AddPenny()
        MyFortune = [Decimal].Add(MyFortune, 0.01D)
    End Sub

    Public Overrides Function ToString() As String
        Return MyFortune.ToString("C") + " in piggy bank"
    End Function

    Protected MyFortune As Decimal
End Class

Comentarios

El ToString() método da formato Decimal a un valor en el formato predeterminado ("G" o general) de la referencia cultural actual.The ToString() method formats a Decimal value in the default ("G", or general) format of the current culture. Si desea especificar un formato o una referencia cultural diferente, use las otras sobrecargas del 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 Usar la sobrecargaUse the overload
Formato predeterminado ("G")Default ("G") format Una referencia cultural específicaA specific culture ToString(IFormatProvider)
Un formato específicoA specific format Referencia cultural predeterminada (actual)Default (current) culture ToString(String)
Un formato específicoA specific format Una referencia cultural específicaA specific culture ToString(String, IFormatProvider)

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

Consulte también:

Se aplica a