Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

Método Decimal.Round (Decimal, Int32)

 
System_CAPS_noteObservação

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Arredonda um valor Decimal para um número especificado de casas decimais.

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

public static decimal Round(
	decimal d,
	int decimals
)

Parâmetros

d
Type: System.Decimal

Um número decimal a ser arredondado.

decimals
Type: System.Int32

Um valor de 0 a 28 que especifica o número de casas decimais para o qual arredondar.

Valor Retornado

Type: System.Decimal

O número decimal equivalente ao d arredondado para o número decimals de casas decimais.

Exception Condition
ArgumentOutOfRangeException

decimals não é um valor de 0 a 28.

Esse método é equivalente a chamar o Round(Decimal, Int32, MidpointRounding) método com um mode argumento de MidpointRounding.ToEven. Quando d é exatamente a meio caminho entre dois valores arredondados, o resultado é o valor arredondado que tem um mesmo dígito na posição decimal à direita. Por exemplo, quando arredondado para duas casas decimais, o valor 2.345 torna-se 2.34 e 2.355 torna-se o valor 2.36. Esse processo é conhecido como arredondamento em direção mesmo, ou do arredondamento bancário. Minimiza os erros de arredondamento que resultam de arredondamento consistentemente um valor de ponto médio em uma única direção.

O exemplo a seguir Arredonda várias Decimal valores para um número especificado de casas decimais usando o Round método.

using System;

class Example
{
   public static void Main()
   {
      // Define a set of Decimal values.
      decimal[] values = { 1.45m, 1.55m, 123.456789m, 123.456789m, 
                           123.456789m, -123.456m, 
                           new Decimal(1230000000, 0, 0, true, 7 ),
                           new Decimal(1230000000, 0, 0, true, 7 ), 
                           -9999999999.9999999999m, 
                           -9999999999.9999999999m };
      // Define a set of integers to for decimals argument.
      int[] decimals = { 1, 1, 4, 6, 8, 0, 3, 11, 9, 10};

      Console.WriteLine("{0,26}{1,8}{2,26}", 
                        "Argument", "Digits", "Result" );
      Console.WriteLine("{0,26}{1,8}{2,26}", 
                        "--------", "------", "------" );
      for (int ctr = 0; ctr < values.Length; ctr++)
        Console.WriteLine("{0,26}{1,8}{2,26}", 
                          values[ctr], decimals[ctr], 
                          Decimal.Round(values[ctr], decimals[ctr]));
    }
}
// The example displays the following output:
//                   Argument  Digits                    Result
//                   --------  ------                    ------
//                       1.45       1                       1.4
//                       1.55       1                       1.6
//                 123.456789       4                  123.4568
//                 123.456789       6                123.456789
//                 123.456789       8                123.456789
//                   -123.456       0                      -123
//               -123.0000000       3                  -123.000
//               -123.0000000      11              -123.0000000
//     -9999999999.9999999999       9    -10000000000.000000000
//     -9999999999.9999999999      10    -9999999999.9999999999

.NET Framework
Disponível desde 1.1
Biblioteca de Classes Portátil
Com suporte no: plataformas portáteis do .NET
Silverlight
Disponível desde 2.0
Windows Phone Silverlight
Disponível desde 7.0
Retornar ao início
Mostrar: