Convert::ToDecimal Method (String^)
Converts the specified string representation of a number to an equivalent decimal number.
Assembly: mscorlib (in mscorlib.dll)
Parameters
- value
-
Type:
System::String^
A string that contains a number to convert.
Return Value
Type: System::DecimalA decimal number that is equivalent to the number in value, or 0 (zero) if value is null.
| Exception | Condition |
|---|---|
| FormatException | value is not a number in a valid format. |
| OverflowException |
Using the ToDecimal(String^) method is equivalent to passing value to the Decimal::Parse(String^) method. value is interpreted by using the formatting conventions of the current thread culture.
If you prefer not to handle an exception if the conversion fails, you can call the Decimal::TryParse method instead. It returns a Boolean value that indicates whether the conversion succeeded or failed.
The following example illustrates the use of ToDecimal. It attempts to convert a Stringto a Decimal, and throws the possible exceptions that may arise during the conversion.
public: void ConvertStringDecimal( String^ stringVal ) { Decimal decimalVal = 0; try { decimalVal = System::Convert::ToDecimal( stringVal ); System::Console::WriteLine( "The String as a decimal is {0}.", decimalVal ); } catch ( System::OverflowException^ ) { System::Console::WriteLine( "The conversion from String to decimal overflowed." ); } catch ( System::FormatException^ ) { System::Console::WriteLine( "The String is not formatted as a decimal." ); } catch ( System::ArgumentNullException^ ) { System::Console::WriteLine( "The String is 0." ); } // Decimal to String conversion will not overflow. stringVal = System::Convert::ToString( decimalVal ); System::Console::WriteLine( "The decimal as a String is {0}.", stringVal ); }
Available since 8
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1