Export (0) Print
Expand All

Convert.ToSingle Method (Object)

Converts the value of the specified object to a single-precision floating-point number.

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

'Declaration
Public Shared Function ToSingle ( _
	value As Object _
) As Single

Parameters

value
Type: System.Object
An object that implements the IConvertible interface, or Nothing.

Return Value

Type: System.Single
A single-precision floating-point number that is equivalent to value, or zero if value is Nothing.

ExceptionCondition
FormatException

value is not in an appropriate format.

InvalidCastException

value does not implement the IConvertible interface.

-or-

The conversion is not supported.

OverflowException

value represents a number that is less than Single.MinValue or greater than Single.MaxValue.

The return value is the result of invoking the IConvertible.ToSingle method of the underlying type of value.

The following example attempts to convert each element in an object array to a Single value.


Dim values() As Object = { True, "a"c, 123, 1.764e32, "9.78", "1e-02", _
                           1.67e03, "A100", "1,033.67", Date.Now, _
                           Decimal.MaxValue }   
Dim result As Single

For Each value As Object In values
   Try
      result = Convert.ToSingle(value)
      Console.WriteLine("Converted the {0} value '{1}' to the {2} value {3}.", _
                        value.GetType().Name, value, _
                        result.GetType().Name, result)

   Catch e As FormatException
      Console.WriteLine("The {0} value {1} is not recognized as a valid Single value.", _
                        value.GetType().Name, value)
   Catch e As OverflowException
      Console.WriteLine("The {0} value {1} is outside the range of the Single type.", _
                        value.GetType().Name, value)

   Catch e As InvalidCastException
      Console.WriteLine("Conversion of the {0} value {1} to a Single is not supported.", _
                        value.GetType().Name, value)
   End Try                     
Next
' The example displays the following output:
'    Converted the Boolean value 'True' to the Single value 1.
'    Conversion of the Char value a to a Single is not supported.
'    Converted the Int32 value '123' to the Single value 123.
'    Converted the Double value '1.764E+32' to the Single value 1.764E+32.
'    Converted the String value '9.78' to the Single value 9.78.
'    Converted the String value '1e-02' to the Single value 0.01.
'    Converted the Double value '1670' to the Single value 1670.
'    The String value A100 is not recognized as a valid Single value.
'    Converted the String value '1,033.67' to the Single value 1033.67.
'    Conversion of the DateTime value 11/7/2008 07:56:24 AM to a Single is not supported.
'    Converted the Decimal value '79228162514264337593543950335' to the Single value 7.922816E+28.


.NET Framework

Supported in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Portable Class Library

Supported in: Portable Class Library

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Community Additions

ADD
Show:
© 2014 Microsoft