# Decimal Explicit Conversion (Decimal to Byte)

.NET Framework (current version)

equivalentCodeEntityM:System.Decimal.ToByte(System.Decimal)

Defines an explicit conversion of a Decimal to an 8-bit unsigned integer.

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

## Syntax

```public:
static explicit operator unsigned char (
Decimal value
)
```

#### Parameters

value
Type: System::Decimal

The value to convert.

#### Return Value

Type: System::Byte

An 8-bit unsigned integer that represents the converted Decimal.

## Exceptions

Exception Condition
OverflowException

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

## Remarks

This operator supports the explicit conversion of a Decimal to a Byte. The syntax for such explicit conversions is language-dependent, and individual language compilers can provide different implementations and return different results. The example illustrates the different return values when you explicitly convert a Decimal value to a Byte value by using C#, Visual Basic, and C++. To perform a conversion that is independent of language, you can call the Decimal::ToByte or the Convert::ToByte(Decimal) method.

## Examples

The following example converts Decimal numbers to Byte values by using the explicit Decimal to Byte conversion.

```using namespace System;

void main()
{
// Define an array of decimal values.
array<Decimal>^ values = { Decimal::Parse("78"),
Decimal(78000,0,0,false,3),
Decimal::Parse("78.999"),
Decimal::Parse("255.999"),
Decimal::Parse("256"),
Decimal::Parse("127.999"),
Decimal::Parse("128"),
Decimal::Parse("-0.999"),
Decimal::Parse("-1"),
Decimal::Parse("-128.999"),
Decimal::Parse("-129") };
for each (Decimal value in values) {
try {
Byte byteValue = (Byte) value;
Console::WriteLine("{0} ({1}) --> {2} ({3})", value,
value.GetType()->Name, byteValue,
byteValue.GetType()->Name);
}
catch (OverflowException^ e) {
Console::WriteLine("OverflowException: Cannot convert {0}",
value);
}
}
}
// The example displays the following output:
//       78 (Decimal) --> 78 (Byte)
//       78.000 (Decimal) --> 78 (Byte)
//       78.999 (Decimal) --> 78 (Byte)
//       255.999 (Decimal) --> 255 (Byte)
//       OverflowException: Cannot convert 256
//       127.999 (Decimal) --> 127 (Byte)
//       128 (Decimal) --> 128 (Byte)
//       -0.999 (Decimal) --> 0 (Byte)
//       OverflowException: Cannot convert -1
//       OverflowException: Cannot convert -128.999
//       OverflowException: Cannot convert -129
```

## Version Information

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