Convert.ToUInt32 Method (Int64)


Converts the value of the specified 64-bit signed integer to an equivalent 32-bit unsigned integer.

This API is not CLS-compliant.

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

Public Shared Function ToUInt32 (
	value As Long
) As UInteger


Type: System.Int64

The 64-bit signed integer to convert.

Return Value

Type: System.UInt32

A 32-bit unsigned integer that is equivalent to value.

Exception Condition

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

The following example attempts to convert each element in a long integer array to an unsigned integer.

Dim numbers() As Long = { Int64.MinValue, -1, 0, 121, 340, Int64.MaxValue }
Dim result As UInteger
For Each number As Long In numbers
      result = Convert.ToUInt32(number)
      Console.WriteLine("Converted the {0} value {1} to the {2} value {3}.", _
                        number.GetType().Name, number, _
                        result.GetType().Name, result)
   Catch e As OverflowException
      Console.WriteLine("The {0} value {1} is outside the range of the UInt32 type.", _
                        number.GetType().Name, number)
   End Try
' The example displays the following output:
'    The Int64 value -9223372036854775808 is outside the range of the UInt32 type.
'    The Int64 value -1 is outside the range of the UInt32 type.
'    Converted the Int64 value 0 to the UInt32 value 0.
'    Converted the Int64 value 121 to the UInt32 value 121.
'    Converted the Int64 value 340 to the UInt32 value 340.
'    The Int64 value 9223372036854775807 is outside the range of the UInt32 type.

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