Convert.ToChar Method (Int64)

Microsoft Silverlight will reach end of support after October 2021. Learn more.

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

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

Syntax

'Declaration
Public Shared Function ToChar ( _
    value As Long _
) As Char
public static char ToChar(
    long value
)

Parameters

Return Value

Type: System.Char
The Unicode character equivalent to the value of value.

Exceptions

Exception Condition
OverflowException

value is less than Char.MinValue or greater than Char.MaxValue.

Examples

The following code sample attempts to convert an Int64 to Char, throwing OverflowException on failure.

Public Sub ConvertLongChar(ByVal longVal As Long)

   Dim charVal As Char = "a"c

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

   ' A conversion from Char to Long cannot overflow.
   longVal = System.Convert.ToInt64(charVal)
   outputBlock.Text &= String.Format("{0} as a Long is {1}", _
                             charVal, longVal) & vbCrLf
End Sub
public void ConvertLongChar(long longVal)
{
   char charVal = 'a';

   try
   {
      charVal = System.Convert.ToChar(longVal);
      outputBlock.Text += String.Format("{0} as a char is {1}",
         longVal, charVal) + "\n";
   }
   catch (System.OverflowException)
   {
      outputBlock.Text += String.Format(
         "Overflow in long-to-char conversion.") + "\n";
   }

   // A conversion from Char to long cannot overflow.
   longVal = System.Convert.ToInt64(charVal);
   outputBlock.Text += String.Format("{0} as an Int64 is {1}",
      charVal, longVal) + "\n";
}

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

XNA Framework

Supported in: Xbox 360, Windows Phone OS 7.0

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.