This documentation is archived and is not being maintained.

Decimal.Implicit Operator

Visual Studio 2008

Converts a 64-bit unsigned integer to a Decimal.

This API is not CLS-compliant.

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

Syntax

```public static implicit operator decimal (
ulong value
)
```

Parameters

value
Type: System.UInt64

A 64-bit unsigned integer.

Return Value

Type: System.Decimal
A Decimal that represents the converted 64-bit unsigned integer.

Examples

The following code example converts UInt64 values to Decimal numbers using the UInt64 to Decimal conversion. This conversion is implicit in C#, but requires the op_Implicit operator in Visual Basic and C++. Implicit conversions to Decimal use other methods in these languages.

```// Example of the implicit conversion from ulong to decimal.
using System;

class DecimalFromUInt64Demo
{
const string formatter =
"{0,20}{1,21}{2,10:X8}{3,9:X8}{4,9:X8}{5,9:X8}";

// Convert the ulong argument and display the decimal value.
public static void DecimalFromUInt64( ulong argument )
{
decimal decValue;
int[ ]  bits;

// Display the decimal and its binary representation.
decValue = argument;
bits = decimal.GetBits( decValue );

Console.WriteLine( formatter, argument, decValue,
bits[ 3 ], bits[ 2 ], bits[ 1 ], bits[ 0 ] );
}

public static void Main( )
{
Console.WriteLine(
"This example of the implicit conversion from ulong " +
"to decimal generates the \nfollowing output. It " +
"displays the decimal value and its binary " +
"representation.\n" );
Console.WriteLine( formatter, "ulong argument",
"decimal value", "bits[3]", "bits[2]",
"bits[1]", "bits[0]" );
Console.WriteLine( formatter, "--------------",
"-------------", "-------", "-------",
"-------", "-------" );

// Convert ulong values and display the results.
DecimalFromUInt64( ulong.MinValue );
DecimalFromUInt64( ulong.MaxValue );
DecimalFromUInt64( 0xFFFFFFFFFFFF );
DecimalFromUInt64( 123456789123456789 );
DecimalFromUInt64( 1000000000000000 );
}
}

/*
This example of the implicit conversion from ulong to decimal generates the
following output. It displays the decimal value and its binary representation.

ulong argument        decimal value   bits[3]  bits[2]  bits[1]  bits[0]
--------------        -------------   -------  -------  -------  -------
0                    0  00000000 00000000 00000000 00000000
18446744073709551615 18446744073709551615  00000000 00000000 FFFFFFFF FFFFFFFF
281474976710655      281474976710655  00000000 00000000 0000FFFF FFFFFFFF
123456789123456789   123456789123456789  00000000 00000000 01B69B4B ACD05F15
1000000000000000     1000000000000000  00000000 00000000 00038D7E A4C68000
*/
```

Platforms

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile for Smartphone, Windows Mobile for Pocket PC, Xbox 360, Zune

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Version Information

.NET Framework

Supported in: 3.5, 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 3.5, 2.0, 1.0

XNA Framework

Supported in: 3.0, 2.0, 1.0