ToString Method

Decimal::ToString Method ()


Converts the numeric value of this instance to its equivalent string representation.

Namespace:   System
Assembly:  mscorlib (in mscorlib.dll)

virtual String^ ToString() override

Return Value

Type: System::String^

A string that represents the value of this instance.

The ToString() method formats a Decimal value in the default ("G", or general) format of the current culture. If you want to specify a different format or culture, use the other overloads of the ToString method, as follows:

To use format

For culture

Use the overload

Default ("G") format

A specific culture


A specific format

Default (current) culture


A specific format

A specific culture

ToString(String^, IFormatProvider^)

The .NET Framework provides extensive formatting support, which is described in greater detail in the following formatting topics:

The following example displays a Decimal value using the default ToString() method. It also displays the string representations of the Decimal value that result from using a number of standard format specifiers.

No code example is currently available or this language may not be supported.

The following example displays the amount of money in an account.

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

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

      Decimal MyFortune;

Universal Windows Platform
Available since 4.5
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
Return to top
© 2015 Microsoft