Énumération System.MidpointRounding

Cet article fournit des remarques supplémentaires à la documentation de référence de cette API.

Utilisez l’énumération MidpointRounding avec les surcharges appropriées de Math.Round, MathF.Roundet Decimal.Round pour fournir un contrôle plus complet du processus d’arrondi.

Il existe deux stratégies générales d’arrondi : arrondi au plus proche et arrondi dirigé, et chaque champ d’énumération participe exactement à l’une de ces stratégies.

Arrondir à la valeur la plus proche

Champs :

• AwayFromZero
• ToEven

Une opération d'arrondi au plus proche prend un nombre original avec une précision implicite ou spécifiée; examine le chiffre suivant, qui correspond à cette précision plus un; et renvoie le nombre le plus proche avec la même précision que le nombre original. Pour les nombres positifs, si le chiffre suivant est compris entre 0 et 4, le nombre le plus proche est vers l’infini négatif. Si le chiffre suivant est compris entre 6 et 9, le nombre le plus proche est vers l’infini positif. Pour les nombres négatifs, si le chiffre suivant est compris entre 0 et 4, le nombre le plus proche est vers l’infini positif. Si le chiffre suivant est compris entre 6 et 9, le nombre le plus proche est vers l’infini négatif.

Si le chiffre suivant est de 0 à 4 ou de 6 à 9, les MidpointRounding.AwayFromZero et MidpointRounding.ToEven n'affectent pas le résultat de l’opération d’arrondi. Toutefois, si le chiffre suivant est égal à 5, qui est le point intermédiaire entre deux résultats possibles et que tous les chiffres restants sont nuls ou qu’il n’y a pas de chiffres restants, le nombre le plus proche est ambigu. Dans ce cas, les modes d’arrondi au plus proche dans MidpointRounding permettent de spécifier si l’opération d’arrondi retourne le nombre le plus proche de zéro ou le nombre pair le plus proche.

Le tableau suivant illustre les résultats de l’arrondi de certains nombres négatifs et positifs en conjonction avec les modes d’arrondi au plus proche. La précision utilisée pour arrondir les nombres est zéro, ce qui signifie que le nombre après la virgule décimale affecte l’opération d’arrondi. Par exemple, pour le nombre -2,5, le chiffre après la virgule décimale est 5. Étant donné que ce chiffre est le point intermédiaire, vous pouvez utiliser une MidpointRounding valeur pour déterminer le résultat de l’arrondi. Si AwayFromZero elle est spécifiée, -3 est retournée, car il s’agit du nombre le plus proche de zéro avec une précision de zéro. Si ToEven elle est spécifiée, -2 est retournée, car il s’agit du nombre pair le plus proche avec une précision de zéro.

Arrondi dirigé

Champs :

• ToNegativeInfinity
• ToPositiveInfinity
• ToZero

Une opération d’arrondi dirigé prend un nombre d’origine avec une précision implicite ou spécifiée et retourne le nombre le plus proche suivant dans une direction spécifique avec la même précision que le nombre d’origine. Les modes dirigés sur MidpointRounding déterminent vers quel nombre prédéfini l’arrondi est effectué.

Le tableau suivant illustre les résultats de l’arrondi de certains nombres négatifs et positifs en conjonction avec les modes d’arrondi dirigé. La précision utilisée pour arrondir les nombres est zéro, ce qui signifie que le nombre avant la virgule décimale est affecté par l’opération d’arrondi.