ToString Method
Collapse the table of content
Expand the table of content

Decimal.ToString Method

[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]

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

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

public override string ToString()

Return Value

Type: System.String
A string that represents the value of this instance.

The return value is formatted with the general numeric format specifier ("G"), and the NumberFormatInfo object for the current culture. To define the formatting of the decimal value's string representation, call the Decimal.ToString(String) method. To define the culture whose formatting is used in the decimal value's string representation, call the Decimal.ToString(IFormatProvider) method. To define both the format specifiers and culture used in creating the string representation of a decimal value, call the Decimal.ToString(String, IFormatProvider) method.

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.

decimal value = -16325.62m;
// Display value using default ToString method.
outputBlock.Text += value.ToString() + "\n";            // Displays -16325.62
// Display value using some standard format specifiers.
outputBlock.Text += value.ToString("G") + "\n";         // Displays -16325.62
outputBlock.Text += value.ToString("C") + "\n";         // Displays ($16,325.62)
outputBlock.Text += value.ToString("F") + "\n";         // Displays -16325.62      

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

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

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

   protected decimal MyFortune;

Windows Phone OS

Supported in: 8.1, 8.0, 7.1, 7.0

Windows Phone

© 2017 Microsoft