Decimal.ToSByte(Decimal) Method

Definition

Important

This API is not CLS-compliant.

CLS-compliant alternative
System.Decimal.ToInt16(Decimal)

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

C#
[System.CLSCompliant(false)]
public static sbyte ToSByte(decimal value);

Parameters

value
Decimal

The decimal number to convert.

Returns

An 8-bit signed integer equivalent to value.

Attributes

Exceptions

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

Examples

The following example uses the ToSByte method to convert decimal numbers to SByte values.

C#
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 {
            sbyte number = Decimal.ToSByte(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
//     OverflowException: 255.999
//     OverflowException: 256
//     127.999 --> 127
//     OverflowException: 128
//     -0.999 --> 0
//     -1 --> -1
//     -128.999 --> -128
//     OverflowException: -129

Remarks

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

Applies to

Product Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

See also