CKTIS / C#
MidpointRounding.AwayFromZero met decimal.Round
Rond af naar de dichtstbijzijnde waarde en kies alleen bij exact gelijke afstand de waarde met de grootste absolute waarde.
Versie: C# 12 and .NET 8; later runtimes may add compatible features
Syntax
public static decimal Round(decimal d, int decimals, System.MidpointRounding mode);
public static decimal Round(decimal d, System.MidpointRounding mode);
// Call with an explicit midpoint rule:
decimal rounded = decimal.Round(2.25m, 1, System.MidpointRounding.AwayFromZero);In C# 12 en .NET 8 retourneert decimal.Round(d, decimals, MidpointRounding.AwayFromZero) een decimal, de C#-alias voor System.Decimal. AwayFromZero is een lid van de enum System.MidpointRounding en wordt als argument mode aan de statische methode doorgegeven. Het achtervoegsel m maakt een literal van het type decimal, niet double.
De methode kiest de dichtstbijzijnde waarde met het gevraagde aantal decimalen. Alleen als beide kandidaten exact even dichtbij liggen, kiest AwayFromZero de waarde met de grootste absolute waarde: op één decimaal wordt 2.25m afgerond naar 2.3m en -2.25m naar -2.3m. Zonder gelijke afstand wordt 2.24m afgerond naar 2.2m. De standaardregel ToEven van decimal.Round(d, decimals) kiest bij gelijke afstand het resultaat waarvan het laatste behouden cijfer even is. De gerichte modus ToZero rondt daarentegen ook zonder gelijke afstand naar nul toe af.
decimals geeft het aantal cijfers na het decimaalteken aan, van 0 tot en met 28. decimal.Round(d, mode) rondt af naar een geheel getal, maar retourneert nog steeds een decimal. Bij de overload met drie argumenten leidt een decimals buiten het bereik tot ArgumentOutOfRangeException en een ongedefinieerde mode tot ArgumentException.
Voorbeelden
using System;
using System.Globalization;
decimal[] values = [2.25m, -2.25m, 2.24m, 2.26m];
Console.WriteLine("Input | Default | AwayFromZero");
foreach (decimal value in values)
{
decimal defaultResult = decimal.Round(value, 1);
decimal explicitResult = decimal.Round(value, 1, MidpointRounding.AwayFromZero);
Console.WriteLine(string.Create(CultureInfo.InvariantCulture,
$"{value:F2} | {defaultResult:F1} | {explicitResult:F1}"));
}Resultaat
Input | Default | AwayFromZero 2.25 | 2.2 | 2.3 -2.25 | -2.2 | -2.3 2.24 | 2.2 | 2.2 2.26 | 2.3 | 2.3
Vergelijk de kolommen: de modi verschillen alleen in de twee rijen met exact gelijke afstand. `CultureInfo.InvariantCulture` zorgt voor een decimale punt in de uitvoer.
Gerelateerde lessen
- C# · Les 7 · Gevorderd · Versie: 3