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
- value
Type: System.Int64
A 64-bit signed integer.
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.