# Decimal Explicit Conversion (Decimal to Int16)

.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.ToInt16(System.Decimal)

Defines an explicit conversion of a Decimal to a 16-bit signed integer.

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

## Syntax

```public:
static explicit operator short (
Decimal value
)
```

#### Parameters

value
Type: System::Decimal

The value to convert.

#### Return Value

Type: System::Int16

A 16-bit signed integer that represents the converted Decimal.

## Exceptions

Exception Condition
OverflowException

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

## Remarks

This operator supports the explicit conversion of a Decimal to a Int16. 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 an Int16 value by using C# and Visual Basic. To perform a conversion that is independent of language, you can call the ToInt16 or the Convert::ToInt16(Decimal) method.

## Examples

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

```// Example of the explicit conversions from Decimal to short and
// Decimal to unsigned short.
using namespace System;
#define formatter "{0,16}{1,19}{2,19}"

// Get the exception type name; remove the namespace prefix.
String^ GetExceptionType( Exception^ ex )
{
String^ exceptionType = ex->GetType()->ToString();
return exceptionType->Substring( exceptionType->LastIndexOf( '.' ) + 1 );
}

// Convert the Decimal argument; catch exceptions that are thrown.
void DecimalToU_Int16( Decimal argument )
{
Object^ Int16Value;
Object^ UInt16Value;

// Convert the argument to a short value.
try
{
Int16Value = (short)argument;
}
catch ( Exception^ ex )
{
Int16Value = GetExceptionType( ex );
}

// Convert the argument to an unsigned short value.
try
{
UInt16Value = (unsigned short)argument;
}
catch ( Exception^ ex )
{
UInt16Value = GetExceptionType( ex );
}

Console::WriteLine( formatter, argument, Int16Value, UInt16Value );
}

int main()
{
Console::WriteLine( "This example of the explicit conversions from Decimal to "
"short \nand Decimal to unsigned short generates the "
"following output. \nIt displays several converted Decimal "
"values.\n" );
Console::WriteLine( formatter, "Decimal argument", "short", "unsigned short" );
Console::WriteLine( formatter, "----------------", "-----", "--------------" );

// Convert Decimal values and display the results.
DecimalToU_Int16( Decimal::Parse(  "123" ) );
DecimalToU_Int16( Decimal(123000,0,0,false,3) );
DecimalToU_Int16( Decimal::Parse(  "123.999" ) );
DecimalToU_Int16( Decimal::Parse(  "65535.999" ) );
DecimalToU_Int16( Decimal::Parse(  "65536" ) );
DecimalToU_Int16( Decimal::Parse(  "32767.999" ) );
DecimalToU_Int16( Decimal::Parse(  "32768" ) );
DecimalToU_Int16( Decimal::Parse(  "-0.999" ) );
DecimalToU_Int16( Decimal::Parse(  "-1" ) );
DecimalToU_Int16( Decimal::Parse(  "-32768.999" ) );
DecimalToU_Int16( Decimal::Parse(  "-32769" ) );
}

/*
This example of the explicit conversions from Decimal to short
and Decimal to unsigned short generates the following output.
It displays several converted Decimal values.

Decimal argument              short     unsigned short
----------------              -----     --------------
123                123                123
123.000                123                123
123.999                123                123
65535.999  OverflowException              65535
65536  OverflowException  OverflowException
32767.999              32767              32767
32768  OverflowException              32768
-0.999                  0                  0
-1                 -1  OverflowException
-32768.999             -32768  OverflowException
-32769  OverflowException  OverflowException
*/
```

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