ToByte Method (Single)

Convert.ToByte Method (Single)


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

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

public static byte ToByte(
	float 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.

Exception Condition

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

The following example converts a Single value to a Byte.

public void ConvertByteSingle(byte byteVal) {
	float floatVal;

	// Byte to float conversion will not overflow.
	floatVal = System.Convert.ToSingle(byteVal);
	System.Console.WriteLine("The byte as a float is {0}.",

	// Float to byte conversion can overflow.
	try {
		byteVal = System.Convert.ToByte(floatVal);
		System.Console.WriteLine("The float as a byte is {0}.",
	catch (System.OverflowException) {
			"The float value is too large for a byte.");

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