ToUInt64 Method (Decimal)

# Convert.ToUInt64 Method (Decimal)

.NET Framework 4.6 and 4.5

Converts the value of the specified decimal number to an equivalent 64-bit unsigned integer.

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

## Syntax

```[CLSCompliantAttribute(false)]
public static ulong ToUInt64(
decimal value
)
```

#### Parameters

value
Type: System.Decimal

The decimal number to convert.

#### Return Value

Type: System.UInt64

value, rounded to the nearest 64-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.

## Exceptions

Exception Condition
OverflowException

value is less than zero or greater than UInt64.MaxValue.

## Examples

The following example attempts to convert each element in an array of Decimal values to an unsigned long integer.

```decimal[] values= { Decimal.MinValue, -1034.23m, -12m, 0m, 147m,
199.55m, 9214.16m, Decimal.MaxValue };
ulong result;

foreach (decimal value in values)
{
try {
result = Convert.ToUInt64(value);
Console.WriteLine("Converted the {0} value '{1}' to the {2} value {3}.",
value.GetType().Name, value,
result.GetType().Name, result);
}
catch (OverflowException) {
Console.WriteLine("{0} is outside the range of the UInt64 type.",
value);
}
}
// The example displays the following output:
//    -79228162514264337593543950335 is outside the range of the UInt64 type.
//    -1034.23 is outside the range of the UInt64 type.
//    -12 is outside the range of the UInt64 type.
//    Converted the Decimal value '0' to the UInt64 value 0.
//    Converted the Decimal value '147' to the UInt64 value 147.
//    Converted the Decimal value '199.55' to the UInt64 value 200.
//    Converted the Decimal value '9214.16' to the UInt64 value 9214.
//    79228162514264337593543950335 is outside the range of the UInt64 type.
```

## Version Information

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