Convert.ToChar Method (UInt64)

 

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

This API is not CLS-compliant.

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

[CLSCompliantAttribute(false)]
public static char ToChar(
	ulong value
)

Parameters

value
Type: System.UInt64

The 64-bit unsigned integer to convert.

Return Value

Type: System.Char

A Unicode character that is equivalent to value.

Exception Condition
OverflowException

value is greater than Char.MaxValue.

The following example converts each element in an array of unsigned long integers to a Char value.

ulong[] numbers = { UInt64.MinValue, 40, 160, 255, 1028,
                    2011, 30001, 207154, Int64.MaxValue };
char result;
foreach (ulong number in numbers)
{
   try {
      result = Convert.ToChar(number);
      Console.WriteLine("{0} converts to '{1}'.", number, result);
   }
   catch (OverflowException) {
      Console.WriteLine("{0} is outside the range of the Char data type.",
                        number);
   }
}   
// The example displays the following output:
//       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.
//       9223372036854775807 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: