• Article

Decimal Constructor (Int64)

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

Initializes a new instance of Decimal to the value of the specified 64-bit signed integer.

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

Syntax

'Declaration
Public Sub New ( _
    value As Long _
)

public Decimal(
    long value
)

Parameters

Examples

The following code example creates several Decimal numbers using the constructor overload that initializes a Decimal structure with an Int64 value.

' Example of the Decimal( Long ) constructor.

Module Example

   ' Create a Decimal object and display its value.
   Sub CreateDecimal(ByVal outputBlock As System.Windows.Controls.TextBlock, ByVal value As Long, ByVal valToStr As String)

      Dim decimalNum As New Decimal(value)

      ' Format the constructor for display.
      Dim ctor As String = _
          String.Format("Decimal( {0} )", valToStr)

      ' Display the constructor and its value.
      outputBlock.Text &= String.Format("{0,-30}{1,22}", ctor, decimalNum) & vbCrLf
   End Sub

   Public Sub Demo(ByVal outputBlock As System.Windows.Controls.TextBlock)

      outputBlock.Text &= _
          "This example of the Decimal( Long ) constructor " & _
          vbCrLf & "generates the following output." & vbCrLf & vbCrLf
      outputBlock.Text &= String.Format("{0,-30}{1,22}", "Constructor", "Value") & vbCrLf
      outputBlock.Text &= String.Format("{0,-30}{1,22}", "-----------", "-----") & vbCrLf

      ' Construct Decimal objects from Long values.
      CreateDecimal(outputBlock, Long.MinValue, "Long.MinValue")
      CreateDecimal(outputBlock, Long.MaxValue, "Long.MaxValue")
      CreateDecimal(outputBlock, 0L, "0")
      CreateDecimal(outputBlock, 999999999999999999, "999999999999999999")
      CreateDecimal(outputBlock, &H2000000000000000, "&H2000000000000000")
      CreateDecimal(outputBlock, &HE000000000000000, "&HE000000000000000")
   End Sub
End Module

' This example of the Decimal( Long ) constructor
' generates the following output.
' 
' Constructor                                    Value
' -----------                                    -----
' Decimal( Long.MinValue )        -9223372036854775808
' Decimal( Long.MaxValue )         9223372036854775807
' Decimal( 0 )                                       0
' Decimal( 999999999999999999 )     999999999999999999
' Decimal( &H2000000000000000 )    2305843009213693952
' Decimal( &HE000000000000000 )   -2305843009213693952

// Example of the decimal( long ) constructor.
using System;

class Example
{
   // Create a decimal object and display its value.
   public static void CreateDecimal(System.Windows.Controls.TextBlock outputBlock, long value, string valToStr)
   {
      decimal decimalNum = new decimal(value);

      // Format the constructor for display.
      string ctor = String.Format("decimal( {0} )", valToStr);

      // Display the constructor and its value.
      outputBlock.Text += String.Format("{0,-35}{1,22}", ctor, decimalNum) + "\n";
   }

   public static void Demo(System.Windows.Controls.TextBlock outputBlock)
   {
      outputBlock.Text += "This example of the decimal( long ) " +
          "constructor \ngenerates the following output.\n" + "\n";
      outputBlock.Text += String.Format("{0,-35}{1,22}", "Constructor", "Value") + "\n";
      outputBlock.Text += String.Format("{0,-35}{1,22}", "-----------", "-----") + "\n";

      // Construct decimal objects from long values.
      CreateDecimal(outputBlock, long.MinValue, "long.MinValue");
      CreateDecimal(outputBlock, long.MaxValue, "long.MaxValue");
      CreateDecimal(outputBlock, 0L, "0L");
      CreateDecimal(outputBlock, 999999999999999999, "999999999999999999");
      CreateDecimal(outputBlock, 0x2000000000000000, "0x2000000000000000");
      CreateDecimal(outputBlock, unchecked((long)0xE000000000000000),
          "(long)0xE000000000000000");
   }
}

/*
This example of the decimal( long ) constructor
generates the following output.

Constructor                                         Value
-----------                                         -----
decimal( long.MinValue )             -9223372036854775808
decimal( long.MaxValue )              9223372036854775807
decimal( 0 )                                            0
decimal( 999999999999999999 )          999999999999999999
decimal( 0x2000000000000000 )         2305843009213693952
decimal( (long)0xE000000000000000 )  -2305843009213693952
*/

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.