This documentation is archived and is not being maintained.

Decimal.Remainder Method

Computes the remainder after dividing two Decimal values.

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

'Declaration
Public Shared Function Remainder ( _
	d1 As Decimal, _
	d2 As Decimal _
) As Decimal

Parameters

d1
Type: System.Decimal
The dividend.
d2
Type: System.Decimal
The divisor.

Return Value

Type: System.Decimal
The remainder after dividing d1 by d2.

ExceptionCondition
DivideByZeroException

d2 is zero.

OverflowException

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

The following code example creates several pairs of Decimal values and calculates the remainders resulting from dividing the two values with the Remainder method.


Module DecimalMulDivRemDemo
    Const dataFmt As String = "{0,-35}{1,31}"

    ' Display Decimal parameters and their product, quotient, and 
    ' remainder.
    Sub ShowDecimalProQuoRem(left as Decimal, right as Decimal)
        Console.WriteLine()
        Console.WriteLine(dataFmt, "Decimal left", left )
        Console.WriteLine( dataFmt, "Decimal right", right )
        Console.WriteLine( dataFmt, 
            "Decimal.Multiply( left, right )", 
            Decimal.Multiply( left, right ) )
        Console.WriteLine( dataFmt, 
            "Decimal.Divide( left, right )", 
            Decimal.Divide( left, right ) )
        Console.WriteLine( dataFmt, 
            "Decimal.Remainder( left, right )", 
            Decimal.Remainder( left, right ) )
    End Sub

    Sub Main( )
        Console.WriteLine( "This example of the " & vbCrLf & 
            "  Decimal.Multiply( Decimal, Decimal ), " & vbCrLf & 
            "  Decimal.Divide( Decimal, Decimal ), and " & vbCrLf & 
            "  Decimal.Remainder( Decimal, Decimal ) " & vbCrLf & 
            "methods generates the following output. It displays " & 
            "the product, " & vbCrLf & "quotient, and remainder " & 
            "of several pairs of Decimal objects." )

        ' Create pairs of Decimal objects.
        ShowDecimalProQuoRem( 1000D, 7D ) 
        ShowDecimalProQuoRem( -1000D, 7D ) 
        ShowDecimalProQuoRem( 
            new Decimal( 1230000000, 0, 0, False, 7 ), 
            0.0012300D )
        ShowDecimalProQuoRem( 12345678900000000D, 
            0.0000000012345678D )
        ShowDecimalProQuoRem( 123456789.0123456789D, 
            123456789.1123456789D )
    End Sub
End Module 

' This example of the
'   Decimal.Multiply( Decimal, Decimal ),
'   Decimal.Divide( Decimal, Decimal ), and
'   Decimal.Remainder( Decimal, Decimal )
' methods generates the following output. It displays the product,
' quotient, and remainder of several pairs of Decimal objects.
' 
' Decimal left                                                  1000
' Decimal right                                                    7
' Decimal.Multiply( left, right )                               7000
' Decimal.Divide( left, right )       142.85714285714285714285714286
' Decimal.Remainder( left, right )                                 6
' 
' Decimal left                                                 -1000
' Decimal right                                                    7
' Decimal.Multiply( left, right )                              -7000
' Decimal.Divide( left, right )      -142.85714285714285714285714286
' Decimal.Remainder( left, right )                                -6
' 
' Decimal left                                           123.0000000
' Decimal right                                              0.00123
' Decimal.Multiply( left, right )                     0.151290000000
' Decimal.Divide( left, right )                            100000.00
' Decimal.Remainder( left, right )                                 0
' 
' Decimal left                                     12345678900000000
' Decimal right                                   0.0000000012345678
' Decimal.Multiply( left, right )          15241577.6390794200000000
' Decimal.Divide( left, right )       10000000729000059778004901.796
' Decimal.Remainder( left, right )                    0.000000000983
' 
' Decimal left                                  123456789.0123456789
' Decimal right                                 123456789.1123456789
' Decimal.Multiply( left, right )     15241578765584515.651425087878
' Decimal.Divide( left, right )       0.9999999991899999933660999449
' Decimal.Remainder( left, right )              123456789.0123456789


.NET Framework

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

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Portable Class Library

Supported in: Portable Class Library

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Show: