Convert.ToUInt16 Method (Decimal)
.NET Framework (current version)
Converts the value of the specified decimal number to an equivalent 16-bit unsigned integer.
This API is not CLS-compliant.
Assembly: mscorlib (in mscorlib.dll)
Parameters
- value
-
Type:
System.Decimal
The decimal number to convert.
Return Value
Type: System.UInt16value, rounded to the nearest 16-bit unsigned integer. If value is halfway between two whole numbers, the even number is returned; that is, 4.5 is converted to 4, and 5.5 is converted to 6.
| Exception | Condition |
|---|---|
| OverflowException | value is less than zero or greater than UInt16.MaxValue. |
The following example converts each element in an array of Decimal values to an unsigned 16-bit integer.
decimal[] numbers = { Decimal.MinValue, -1034.23m, -12m, 0m, 147m, 9214.16m, Decimal.MaxValue }; ushort result; foreach (decimal number in numbers) { try { result = Convert.ToUInt16(number); Console.WriteLine("Converted the {0} value '{1}' to the {2} value {3}.", number.GetType().Name, number, result.GetType().Name, result); } catch (OverflowException) { Console.WriteLine("{0} is outside the range of the UInt16 type.", number); } } // The example displays the following output: // -79228162514264337593543950335 is outside the range of the UInt16 type. // -1034.23 is outside the range of the UInt16 type. // -12 is outside the range of the UInt16 type. // Converted the Decimal value '0' to the UInt16 value 0. // Converted the Decimal value '147' to the UInt16 value 147. // Converted the Decimal value '9214.16' to the UInt16 value 9214. // 79228162514264337593543950335 is outside the range of the UInt16 type.
Universal Windows Platform
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
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
Show: