# Decimal Explicit Conversion (Decimal to Byte)

.NET Framework (current version)

Note

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

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 byte (
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 System;

class Example
{
public static void Main()
{
// Define an array of decimal values.
decimal[] values = { 78m, new Decimal(78000, 0, 0, false, 3),
78.999m, 255.999m, 256m, 127.999m,
128m, -0.999m, -1m, -128.999m, -129m };
foreach (var value in values) {
try {
Byte byteValue = (Byte) value;
Console.WriteLine("{0} ({1}) --> {2} ({3})", value,
value.GetType().Name, byteValue,
byteValue.GetType().Name);
}
catch (OverflowException) {
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