Decimal.ToString Método

Referencia

Definición

Espacio de nombres:: System

Ensamblado:: System.Runtime.dll

Ensamblado:: netstandard.dll

Ensamblado:: mscorlib.dll

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 String equivalente.

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.
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(String)	Convierte el valor numérico de esta instancia en la representación de cadena equivalente usando el formato especificado.
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.

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

String

Representación en forma de cadena del valor de esta instancia, tal y como especifica provider.

Implementaciones

ToString(IFormatProvider)

Ejemplos

En el ejemplo siguiente se muestra la representación de cadena de un Decimal valor mediante objetos que representan varias referencia CultureInfo culturales diferentes.

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 método da formato a un valor con el formato ToString(IFormatProvider) Decimal 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 método ToString , como se muestra a continuación:

Para usar el formato	Para la 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 Aplicar formato a tipos.

El provider parámetro es una implementación cuyo método devuelve un objeto IFormatProvider IFormatProvider.GetFormat NumberFormatInfo . Normalmente, provider es un objeto o un objeto NumberFormatInfo CultureInfo . El provider parámetro proporciona información específica de la referencia cultural utilizada en el formato. Si provider es null, se usa la referencia cultural actual del subproceso.

Para convertir un valor en su representación de cadena mediante una referencia cultural especificada y Decimal una cadena de formato específica, llame al método Decimal.ToString(String, IFormatProvider) .

Consulte también

Se aplica a

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.

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.

provider: IFormatProvider

Objeto que proporciona información de formato específica de la referencia cultural.

Devoluciones

String

Representación de cadena del valor de esta instancia, tal y como especifican format y provider.

Implementaciones

ToString(String, IFormatProvider)

Excepciones

FormatException

format no es válido.

Ejemplos

En el ejemplo siguiente se muestra un valor que usa cada uno de los especificadores de formato numérico Decimal estándar admitidos para varias referencia culturales diferentes.

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 a un valor en un formato especificado de una referencia cultural Decimal especificada. Si desea usar la configuración de formato o referencia cultural predeterminada, use las demás sobrecargas del método ToString , como se muestra a continuación:

Para usar el formato	Para la 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 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 format formato numérico personalizado. Si es o una cadena vacía, el valor devuelto para esta instancia tiene el formato del especificador de formato numérico format null 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 Aplicar formato a tipos.

El provider parámetro es una implementación cuyo método devuelve un objeto IFormatProvider IFormatProvider.GetFormat NumberFormatInfo . Normalmente, provider es un objeto o NumberFormatInfo CultureInfo . El provider parámetro proporciona información específica de la referencia cultural utilizada en el formato. Si provider es null, se usa la referencia cultural actual del subproceso.

Consulte también

Se aplica a

ToString(String)

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

String

Representación en forma de cadena del valor de esta instancia, tal y como especifica format.

Excepciones

FormatException

format no es válido.

Ejemplos

En el ejemplo siguiente se muestra un valor que usa cada uno de los especificadores de formato numérico estándar Decimal admitidos, junto con dos cadenas de formato numérico personalizado. Al convertir los valores numéricos en cadenas, en el ejemplo se usan las convenciones de formato de la referencia cultural en-US.

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 a un valor en un formato especificado mediante las Decimal 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 método, como ToString se muestra a continuación:

Para usar el formato	Para la 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 método usa la cadena de formato numérico estándar o personalizado especificada por el parámetro para convertir el valor de la instancia ToString actual en su representación de format cadena. El 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 format formato numérico personalizado. Si es o una cadena vacía, el valor devuelto de esta instancia tiene el formato del format null 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 Aplicar formato a tipos.

El valor devuelto se formateará mediante el NumberFormatInfo objeto para la referencia cultural actual. Para aplicar las convenciones de formato de una referencia cultural especificada, llame al ToString(String, IFormatProvider) método .

Consulte también

Se aplica a

ToString()

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

String

Cadena que representa el valor de esta instancia.

Ejemplos

En el ejemplo siguiente se muestra Decimal un valor mediante el método ToString() predeterminado. También muestra las representaciones de cadena del valor resultante del uso de varios Decimal especificadores de formato estándar.

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.

   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 a un valor con el formato predeterminado Decimal ("G" o general) de la referencia cultural actual. Si desea especificar un formato o una referencia cultural diferentes, use las demás sobrecargas del método ToString , como se muestra a continuación:

Para usar el formato	Para la 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 Aplicar formato a tipos.

Consulte también

Se aplica a