Decimal Explicit Conversion (Decimal to Char)

 
equivalentCodeEntityM:System.Decimal.ToInt16(System.Decimal)

Defines an explicit conversion of a Decimal to a Unicode character.

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

public static explicit operator char (
	decimal value
)

Parameters

value
Type: System.Decimal

The value to convert.

Return Value

Type: System.Char

A Unicode character that represents the converted Decimal.

Exception Condition
OverflowException

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

This operator supports the explicit conversion of a Decimal to a Char. The syntax for such explicit conversions is language-dependent, and individual language compilers might provide different implementations and return different results, or might not support the conversion at all. For example, the Visual Basic and C++ compilers do not support an explicit Decimal to Char conversion.

The following example converts Decimal numbers to Char values (Unicode characters) by using the explicit Decimal to Char conversion.

using System;

class Example
{
   public static void Main( )
   {
      // Define an array of decimal values.
      decimal[] values = { 3.33m, 55.5m, 77.7m, 123m, 123.999m, 170m,
                           188.88m, 222m, 244m, 8217m, 8250m, 65536m, 
                           -1m };
      // Convert each value to a Char.
      foreach (decimal value in values) {
         try {
            char charValue = (char) value;
            Console.WriteLine("{0} --> {1} ({2:X4})", value, 
                              charValue, (ushort) charValue); 
         }
         catch (OverflowException) {
            Console.WriteLine("OverflowException: Cannot convert {0}",
                              value);
         }
      }
   }
}
// The example displays the following output:
//       3.33 --> ? (0003)
//       55.5 --> 7 (0037)
//       77.7 --> M (004D)
//       123 --> { (007B)
//       123.999 --> { (007B)
//       170 --> � (00AA)
//       188.88 --> � (00BC)
//       222 --> _ (00DE)
//       244 --> � (00F4)
//       8217 --> ' (2019)
//       8250 --> > (203A)
//       OverflowException: Cannot convert 65536
//       OverflowException: Cannot convert -1

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: