Decimal.ToSByte Method (Decimal)


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


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

This API is not CLS-compliant.

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

Public Shared Function ToSByte (
	value As Decimal
) As SByte


Type: System.Decimal

The decimal number to convert.

Return Value

Type: System.SByte

An 8-bit signed integer equivalent to value.

Exception Condition

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

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

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

Module Example
   Public Sub Main()
      Dim values() As Decimal = { 78d, New Decimal(78000, 0, 0, false, 3), 
                                  78.999d, 255.999d, 256d,
                                  127.999d, 128d, -0.999d, 
                                  -1d,  -128.999d, -129d }

      For Each value In values
            Dim number As SByte = Decimal.ToSByte(value)
            Console.WriteLine("{0} --> {1}", value, number)       
         Catch e As OverflowException
             Console.WriteLine("{0}: {1}", e.GetType().Name, value)
         End Try   
   End Sub
End Module
' 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

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