Convert.ToChar Method (Int64)

 

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

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

Public Shared Function ToChar (
	value As Long
) As Char

Parameters

value
Type: System.Int64

The 64-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 attempts to convert a long integer to a Char, and throws a OverflowException on failure.

Public Sub ConvertLongChar(ByVal longVal As Long)

    Dim charVal As Char = "a"c

    Try
        charVal = System.Convert.ToChar(longVal)
        System.Console.WriteLine("{0} as a char is {1}", _
                                  longVal, charVal)
    Catch exception As System.OverflowException
        System.Console.WriteLine( _
            "Overflow in Long-to-Char conversion.")
    End Try

    ' A conversion from Char to Long cannot overflow.
    longVal = System.Convert.ToInt64(charVal)
    System.Console.WriteLine("{0} as a Long is {1}", _
                              charVal, longVal)
End Sub

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: