Export (0) Print
Expand All

Convert.ToUInt16 Method (Int16)

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

This API is not CLS-compliant. 

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

[CLSCompliantAttribute(false)]
public static ushort ToUInt16(
	short value
)

Parameters

value
Type: System.Int16

The 16-bit signed integer to convert.

Return Value

Type: System.UInt16
A 16-bit unsigned integer that is equivalent to value.

ExceptionCondition
OverflowException

value is less than zero.

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

short[] numbers = { Int16.MinValue, -132, 0, 121, 16103, Int16.MaxValue  };
ushort result;

foreach (short number in numbers)
{
   try {
      result = Convert.ToUInt16(number);
      Console.WriteLine("Converted the {0} value '{1}' to the {2} value {3}.", 
                        number.GetType().Name, number, 
                        result.GetType().Name, result);
   }
   catch (OverflowException) {
      Console.WriteLine("The {0} value {1} is outside the range of the UInt16 type.",
                        number.GetType().Name, number);
   }
}
// The example displays the following output: 
//    The Int16 value -32768 is outside the range of the UInt16 type. 
//    The Int16 value -132 is outside the range of the UInt16 type. 
//    Converted the Int16 value '0' to the UInt16 value 0. 
//    Converted the Int16 value '121' to the UInt16 value 121. 
//    Converted the Int16 value '16103' to the UInt16 value 16103. 
//    Converted the Int16 value '32767' to the UInt16 value 32767.

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0, 1.1

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

XNA Framework

Supported in: 3.0, 2.0, 1.0

Portable Class Library

Supported in: Portable Class Library

Supported in: Windows Phone 8.1

Supported in: Windows Phone Silverlight 8.1

Supported in: Windows Phone Silverlight 8
Show:
© 2015 Microsoft