Decimal.Increment(Decimal) Operator

Definition

Increments the Decimal operand by 1.

public:
 static System::Decimal operator ++(System::Decimal d);
public:
 static System::Decimal operator ++(System::Decimal d) = System::Numerics::IIncrementOperators<System::Decimal>::op_Increment;
public static decimal operator ++ (decimal d);
static member op_Increment : decimal -> decimal
Public Shared op_Increment (d As Decimal) As Decimal

Parameters

d
Decimal

The value to increment.

Returns

The value of d incremented by 1.

Implements

Exceptions

The return value is less than Decimal.MinValue or greater than Decimal.MaxValue.

Remarks

The Increment method defines the operation of the increment operator for Decimal values. It enables code such as the following:

using System;

public class Example
{
   public static void Main()
   {
      Decimal number = 1079.8m;
      Console.WriteLine("Original value:    {0:N}", number);
      Console.WriteLine("Incremented value: {0:N}", ++number);
   }
}
// The example displays the following output:
//       Original value:    1,079.80
//       Incremented value: 1,080.80
open System

let number = 1079.8m
printfn $"Original value:    {number:N}"
printfn $"Incremented value: {Decimal.op_Increment number:N}"

// The example displays the following output:
//       Original value:    1,079.80
//       Incremented value: 1,080.80

Some languages (such as Visual Basic) that lack an increment operator can call the Increment method directly, as the following example shows.

Module Example
   Public Sub Main()
      Dim number As Decimal = 1079.8d
      Console.WriteLine("Original value:    {0:N}", number)
      Console.WriteLine("Incremented value: {0:N}", Decimal.op_Increment(number))
   End Sub
End Module
' The example displays the following output:
'       Original value:    1,079.80
'       Incremented value: 1,080.80

If your language does not support custom operators, call the Add method instead, as the following example shows.

using System;

public class Example
{
   public static void Main()
   {
      Decimal number = 1079.8m;
      Console.WriteLine("Original value:    {0:N}", number);
      Console.WriteLine("Incremented value: {0:N}", Decimal.Add(number, 1));
   }
}
// The example displays the following output:
//       Original value:    1,079.80
//       Incremented value: 1,080.80
open System

let number = 1079.8m
printfn $"Original value:    {number:N}"
printfn $"Incremented value: {Decimal.Add(number, 1):N}"

// The example displays the following output:
//       Original value:    1,079.80
//       Incremented value: 1,080.80
Module Example
   Public Sub Main()
      Dim number As Decimal = 1079.8d
      Console.WriteLine("Original value:    {0:N}", number)
      Console.WriteLine("Incremented value: {0:N}", Decimal.Add(number, 1))
   End Sub
End Module
' The example displays the following output:
'       Original value:    1,079.80
'       Incremented value: 1,080.80

Applies to

See also