This topic has not yet been rated - Rate this topic

Convert.ToChar Method (SByte)

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

This API is not CLS-compliant. 

Namespace:  System
Assembly:  mscorlib (in mscorlib.dll)
'Declaration
<CLSCompliantAttribute(False)> _
Public Shared Function ToChar ( _
	value As SByte _
) As Char

Parameters

value
Type: System.SByte

The 8-bit signed integer to convert.

Return Value

Type: System.Char
A Unicode character that is equivalent to value.
ExceptionCondition
OverflowException

value is less than Char.MinValue.

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

Dim numbers() As SByte = { SByte.MinValue, -1, 40, 80, 120, SByte.MaxValue }
Dim result As Char 
For Each number As SByte 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: 
'       -128 is outside the range of the Char data type. 
'       -1 is outside the range of the Char data type. 
'       40 converts to '('. 
'       80 converts to 'P'. 
'       120 converts to 'x'. 
'       127 converts to '⌂'.

.NET Framework

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

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Portable Class Library

Supported in: Portable Class Library

.NET for Windows Store apps

Supported in: Windows 8

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Did you find this helpful?
(1500 characters remaining)
© 2013 Microsoft. All rights reserved.