Convert.ToInt16 Method (UInt16)


Converts the value of the specified 16-bit unsigned integer to the equivalent 16-bit signed integer.

This API is not CLS-compliant.

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

Public Shared Function ToInt16 (
	value As UShort
) As Short


Type: System.UInt16

The 16-bit unsigned integer to convert.

Return Value

Type: System.Int16

A 16-bit signed integer that is equivalent to value.

Exception Condition

value is greater than Int16.MaxValue.

The following example attempts to convert each element in an array of unsigned 16-bit integers to a 16-bit signed integer.

Dim numbers() As UShort = { UInt16.MinValue, 121, 340, UInt16.MaxValue }
Dim result As Short
For Each number As UShort In numbers
      result = Convert.ToInt16(number)
      Console.WriteLine("Converted the {0} value {1} to a {2} value {3}.", _
                        number.GetType().Name, number, _
                        result.GetType().Name, result)
   Catch e As OverflowException
      Console.WriteLine("The {0} value {1} is outside the range of the Int16 type.", _
                        number.GetType().Name, number)
   End Try
' The example displays the following output:
'       Converted the UInt16 value 0 to a Int16 value 0.
'       Converted the UInt16 value 121 to a Int16 value 121.
'       Converted the UInt16 value 340 to a Int16 value 340.
'       The UInt16 value 65535 is outside the range of the Int16 type.

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