Export (0) Print
Expand All

Convert.ToByte Method (Single)

Converts the value of the specified single-precision floating-point number to an equivalent 8-bit unsigned integer.

Namespace:  System
Assemblies:   System.Runtime.Extensions (in System.Runtime.Extensions.dll)
  mscorlib (in mscorlib.dll)

'Declaration
Public Shared Function ToByte ( _
	value As Single _
) As Byte

Parameters

value
Type: System.Single

A single-precision floating-point number.

Return Value

Type: System.Byte
value, rounded to the nearest 8-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.

ExceptionCondition
OverflowException

value is greater than Byte.MaxValue or less than Byte.MinValue.

The following example converts a Single value to a Byte.

Public Sub ConvertByteSingle(ByVal byteVal As Byte)
    Dim singleVal As Single 

    ' Byte to float conversion will not overflow.
    singleVal = System.Convert.ToSingle(byteVal)
    System.Console.WriteLine("The byte as a single is {0}.", _
                              singleVal)

    ' Single to byte conversion can overflow. 
    Try
        byteVal = System.Convert.ToByte(singleVal)
        System.Console.WriteLine("The single as a byte is {0}.", _
                                  byteVal)
    Catch exception As System.OverflowException
        System.Console.WriteLine( _
            "Overflow in single-to-byte conversion.")
    End Try 
End Sub

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0, 1.1

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

XNA Framework

Supported in: 3.0, 2.0, 1.0

Portable Class Library

Supported in: Portable Class Library

Supported in: Windows Phone 8.1

Supported in: Windows Phone Silverlight 8.1

Supported in: Windows Phone Silverlight 8
Show:
© 2015 Microsoft