Convert.ToChar Method (Int16)

 
System_CAPS_noteNote

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

Converts the value of the specified 16-bit signed integer to its equivalent Unicode character.

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

Public Shared Function ToChar (
	value As Short
) As Char

Parameters

value
Type: System.Int16

The 16-bit signed integer to convert.

Return Value

Type: System.Char

A Unicode character that is equivalent to value.

Exception Condition
OverflowException

value is less than Char.MinValue.

The following example converts an array of signed 16-bit integers to Char values.

Dim numbers() As Short = { Int16.MinValue, 0, 40, 160, 255, 1028, _
                           2011, Int16.MaxValue }
Dim result As Char
For Each number As Short In numbers
   Try
      result = Convert.ToChar(number)
      Console.WriteLine("{0} converts to '{1}'.", number, result)
   Catch e As OverflowException
      Console.WriteLine("{0} is outside the range of the Char data type.", _
                        number)
   End Try
Next   
' The example displays the following output:
'       -32768 is outside the range of the Char data type.
'       0 converts to ' '.
'       40 converts to '('.
'       160 converts to ' '.
'       255 converts to 'ÿ'.
'       1028 converts to '?'.
'       2011 converts to '?'.
'       32767 converts to '?'.      

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
Return to top
Show: