Convert::ToByte Method (Decimal)


Converts the value of the specified decimal number to an equivalent 8-bit unsigned integer.

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

static unsigned char ToByte(
	Decimal value


Type: System::Decimal

The 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

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

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

   void ConvertByteDecimal( Byte byteVal )
      Decimal decimalVal;

      // Byte to decimal conversion will not overflow.
      decimalVal = System::Convert::ToDecimal( byteVal );
      System::Console::WriteLine( "The Byte as a decimal is {0}.",
         decimalVal );

      // Decimal to Byte conversion can overflow.
         byteVal = System::Convert::ToByte( decimalVal );
         System::Console::WriteLine( "The Decimal as a Byte is {0}.",
         byteVal );
      catch ( System::OverflowException^ ) 
            "The decimal 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
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
Return to top