# Decimal.ToByte Method (Decimal)

.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.

Converts the value of the specified Decimal to the equivalent 8-bit unsigned integer.

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

## Syntax

```public static byte ToByte(
decimal value
)
```

#### Parameters

value
Type: System.Decimal

The decimal number to convert.

#### Return Value

Type: System.Byte

An 8-bit unsigned integer equivalent to value.

## Exceptions

Exception Condition
OverflowException

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

## Remarks

Parameter value is rounded to the nearest integer value toward zero, and that result is returned.

You can also convert a Decimal value to an 8-bit unsigned integer by using the Explicit(Decimal to Byte) assignment operator. Because the operator performs a narrowing conversion, you must use a casting operator in C# or a conversion function in Visual Basic.

## Examples

The following example uses the ToByte method to convert decimal numbers to Byte values.

```using System;

class Example
{
public static void Main( )
{
decimal[] values = { 123m, 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 number = Decimal.ToByte(value);
Console.WriteLine("{0} --> {1}", value, number);
}
catch (OverflowException e)
{
Console.WriteLine("{0}: {1}", e.GetType().Name, value);
}
}
}
}
// The example displays the following output:
//     78 --> 78
//     78.000 --> 78
//     78.999 --> 78
//     255.999 --> 255
//     OverflowException: 256
//     127.999 --> 127
//     128 --> 128
//     -0.999 --> 0
//     OverflowException: -1
//     OverflowException: -128.999
//     OverflowException: -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