Information
Switch
Switch
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 (Double)

.NET Framework (current version)
 

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

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

C#
C++
F#
VB
Copy 
public:
static unsigned char ToByte(
	double value
)

Parameters

value
Type: System::Double

The double-precision floating-point number to convert.

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
OverflowException

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

The following example converts a Byte value to a Double and a Double value to a Byte.

C#
C++
VB
Copy 
public:
   void ConvertDoubleByte( double doubleVal )
   {
      Byte byteVal = 0;

      // Double to Byte conversion can overflow.
      try
      {
         byteVal = System::Convert::ToByte( doubleVal );
         System::Console::WriteLine( " {0} as a Byte is: {1}.",
         doubleVal, byteVal );
      }
      catch ( System::OverflowException^ ) 
      {
         System::Console::WriteLine( "Overflow in double-to-Byte conversion." );
      }

      // Byte to double conversion cannot overflow.
      doubleVal = System::Convert::ToDouble( byteVal );
      System::Console::WriteLine( " {0} as a double is: {1}.",
         byteVal, doubleVal );
   }

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
Return to top
Show: