Convert.ToUInt32 Method (Single)
.NET Framework (current version)
Converts the value of the specified single-precision floating-point number to an equivalent 32-bit unsigned integer.
This API is not CLS-compliant.
Assembly: mscorlib (in mscorlib.dll)
Parameters
- value
-
Type:
System.Single
The single-precision floating-point number to convert.
Return Value
Type: System.UInt32value, rounded to the nearest 32-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 UInt32.MaxValue. |
The following example attempts to convert each element in an array of Single values to an unsigned integer.
float[] values= { Single.MinValue, -1.38e10f, -1023.299f, -12.98f, 0f, 9.113e-16f, 103.919f, 17834.191f, Single.MaxValue }; uint result; foreach (float value in values) { try { result = Convert.ToUInt32(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("The {0} value {1} is outside the range of the UInt32 type.", value.GetType().Name, value); } } // The example displays the following output: // The Single value -3.402823E+38 is outside the range of the UInt32 type. // The Single value -1.38E+10 is outside the range of the UInt32 type. // The Single value -1023.299 is outside the range of the UInt32 type. // The Single value -12.98 is outside the range of the UInt32 type. // Converted the Single value 0 to the UInt32 value 0. // Converted the Single value 9.113E-16 to the UInt32 value 0. // Converted the Single value 103.919 to the UInt32 value 104. // Converted the Single value 17834.19 to the UInt32 value 17834. // The Single value 3.402823E+38 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
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: