Convert.ToChar Method (Int32)

 

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

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

Public Shared Function ToChar (
	value As Integer
) As Char

Parameters

value
Type: System.Int32

The 32-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 or greater than Char.MaxValue.

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

   Dim numbers() As Integer = { -1, 0, 40, 160, 255, 1028, _
                              2011, 30001, 207154, Int32.MaxValue }
   Dim result As Char
   For Each number As Integer 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   
End Sub
'       -1 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 '?'.
'       30001 converts to '?'.
'       207154 is outside the range of the Char data type.
'       2147483647 is outside the range of the Char data type.   

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: