Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Decrement Operator

Decimal.Decrement Operator

Decrements the Decimal operand by one.

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

public static decimal operator --(
	decimal d
)

Parameters

d
Type: System.Decimal

The value to decrement.

Return Value

Type: System.Decimal
The value of d decremented by 1.

ExceptionCondition
OverflowException

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

The Decrement method defines the operation of the decrement 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("Decremented value: {0:N}", --number); 
   }
}
// The example displays the following output: 
//       Original value:    1,079.80 
//       Decremented value: 1,078.80

Some languages (such as Visual Basic) that lack an increment operator can call the Decrement 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("Decremented value: {0:N}", Decimal.op_Decrement(number))
   End Sub 
End Module 
' The example displays the following output: 
'       Original value:    1,079.80 
'       Decremented value: 1,078.80

If your language does not support custom operators, call the Subtract 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("Decremented value: {0:N}", Decimal.Subtract(number, 1)); 
   }
}
// The example displays the following output: 
//       Original value:    1,079.80 
//       Decremented value: 1,078.80

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0, 1.1

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

XNA Framework

Supported in: 3.0, 2.0, 1.0

.NET for Windows Phone apps

Supported in: Windows Phone 8.1, Windows Phone Silverlight 8.1, Windows Phone Silverlight 8

Portable Class Library

Supported in: Portable Class Library
Show:
© 2015 Microsoft