mscorlib 2.0.0.0 4.0.0.0 System.Enum System.Runtime.InteropServices.ComVisible(true)

Use with appropriate overloads of to provide more control of the rounding process.

A rounding operation takes an original number with an implicit or specified precision; examines the next digit, which is at that precision plus one; and returns the nearest number with the same precision as the original number. For positive numbers, if the next digit is from 0 through 4, the nearest number is toward negative infinity. If the next digit is from 6 through 9, the nearest number is toward positive infinity. For negative numbers, if the next digit is from 0 through 4, the nearest number is toward positive infinity. If the next digit is from 6 through 9, the nearest number is toward negative infinity.

In the previous cases, the enumeration does not affect the result of the rounding operation. However, if the next digit is 5, which is the midpoint between two possible results, the nearest number is ambiguous. In this case, the enumeration enables you to specify whether the rounding operation returns the nearest number away from zero or the nearest even number.

The following table demonstrates the results of rounding some negative and positive numbers in conjunction with the values of . The precision used to round the numbers is zero, which means the number after the decimal point affects the rounding operation. For example, for the number -2.5, the digit after the decimal point is 5. Because that digit is the midpoint, you can use a value to determine the result of rounding. If is specified, -3 is returned because it is the nearest number away from zero with a precision of zero. If is specified, -2 is returned because it is the nearest even number with a precision of zero.

Original number

AwayFromZero

ToEven

3.5

4

4

2.8

3

3

2.5

3

2

2.1

2

2

-2.1

-2

-2

-2.5

-3

-2

-2.8

-3

-3

-3.5

-4

-4

Specifies how mathematical rounding methods should process a number that is midway between two numbers.

- Field
  2.0.0.0
  4.0.0.0
  System.MidpointRounding

  When a number is halfway between two others, it is rounded toward the nearest number that is away from zero.

- Field
  2.0.0.0
  4.0.0.0
  System.MidpointRounding

  When a number is halfway between two others, it is rounded toward the nearest even number.