The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.
Convert::ToByte Method (Single)
.NET Framework (current version)
Converts the value of the specified single-precision floating-point number to an equivalent 8-bit unsigned integer.
Assembly: mscorlib (in mscorlib.dll)
Parameters
- value
-
Type:
System::Single
A single-precision floating-point number.
Return Value
Type: System::Bytevalue, 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 |
|---|---|
| OverflowException | 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}.", floatVal ); // Float to Byte conversion can overflow. try { byteVal = System::Convert::ToByte( floatVal ); System::Console::WriteLine( "The float as a Byte is {0}.", byteVal ); } catch ( System::OverflowException^ ) { System::Console::WriteLine( "The float value is too large for a Byte." ); } }
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: