Export (0) Print
Expand All

Decimal.ToString Method

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

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 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile for Smartphone, Windows Mobile for Pocket PC, Xbox 360, Zune

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5, 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 3.5, 2.0, 1.0

XNA Framework

Supported in: 3.0, 2.0, 1.0

Community Additions

ADD
Show:
© 2015 Microsoft