This documentation is archived and is not being maintained.

Convert::ToDecimal Method (Double)

Converts the value of the specified double-precision floating-point number to an equivalent decimal number.

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

public:
static Decimal ToDecimal(
	double value
)

Parameters

value
Type: System::Double
The double-precision floating-point number to convert.

Return Value

Type: System::Decimal
A decimal number that is equivalent to value.

ExceptionCondition
OverflowException

value is greater than Decimal::MaxValue or less than Decimal::MinValue.

The Decimal value returned by this method contains a maximum of 15 significant digits. If the value parameter contains more than 15 significant digits, it is rounded using rounding to nearest. The following example illustrates how the Convert::ToDecimal(Double) method uses rounding to nearest to return a Decimal value with 15 significant digits.

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

The following example converts a Double value to a Decimal value.


public:
   void ConvertDoubleDecimal( double doubleVal )
   {
      Decimal decimalVal;

      // Conversion from double to decimal cannot overflow.
      decimalVal = System::Convert::ToDecimal( doubleVal );
      System::Console::WriteLine( " {0} as a decimal is: {1}",
         doubleVal, decimalVal );

      // Decimal to double conversion can overflow.
      try
      {
         doubleVal = System::Convert::ToDouble( decimalVal );
         System::Console::WriteLine( " {0} as a double is: {1}",
         decimalVal, doubleVal );
      }
      catch ( System::OverflowException^ ) 
      {
         System::Console::WriteLine( "Overflow in decimal-to-double conversion." );
      }
   }


.NET Framework

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

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Portable Class Library

Supported in: Portable Class Library

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Show: