Convert::ToDecimal Method (Object^)


Converts the value of the specified object to an equivalent decimal number.

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

static Decimal ToDecimal(
	Object^ value


Type: System::Object^

An object that implements the IConvertible interface, or null.

Return Value

Type: System::Decimal

A decimal number that is equivalent to value, or 0 (zero) if value is null.

Exception Condition

value is not in an appropriate format for a Decimal type.


value does not implement the IConvertible interface.


The conversion is not supported.


value represents a number that is less than Decimal::MinValue or greater than Decimal::MaxValue.

The return value is the result of invoking the IConvertible::ToDecimal method of the underlying type of value.

The following example tries to convert each element in an object array to a Decimal value.

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

Universal Windows Platform
Available since 8
.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