Ler em inglês

Partilhar via


MidpointRounding Enumeração

Definição

Especifica a estratégia que os métodos de arredondamento matemáticos devem usar para arredondar um número.

public enum MidpointRounding
[System.Runtime.InteropServices.ComVisible(true)]
public enum MidpointRounding
Herança
MidpointRounding
Atributos

Campos

AwayFromZero 1

A estratégia de arredondar para o número mais próximo e, quando um número está na metade entre outros dois, ele é arredondado para o número mais próximo que está longe de zero.

ToEven 0

A estratégia de arredondamento para o número mais próximo e, quando um número está na metade entre outros dois, ele é arredondado em direção ao número par mais próximo.

ToNegativeInfinity 3

A estratégia de arredondamento direcionado para baixo, com o resultado mais próximo de e não maior que o resultado infinitamente preciso.

ToPositiveInfinity 4

A estratégia de arredondamento direcionado para cima, com o resultado mais próximo de e nada menos que o resultado infinitamente preciso.

ToZero 2

A estratégia de arredondamento direcionado em direção a zero, com o resultado mais próximo de e não maior em magnitude do que o resultado infinitamente preciso.

Exemplos

O exemplo a seguir demonstra o Math.Round método em conjunto com a MidpointRounding enumeração :

decimal result;

// Round a positive value using different strategies.
// The precision of the result is 1 decimal place.

result = Math.Round(3.45m, 1, MidpointRounding.ToEven);
Console.WriteLine($"{result} = Math.Round({3.45m}, 1, MidpointRounding.ToEven)");
result = Math.Round(3.45m, 1, MidpointRounding.AwayFromZero);
Console.WriteLine($"{result} = Math.Round({3.45m}, 1, MidpointRounding.AwayFromZero)");
result = Math.Round(3.47m, 1, MidpointRounding.ToZero);
Console.WriteLine($"{result} = Math.Round({3.47m}, 1, MidpointRounding.ToZero)\n");

// Round a negative value using different strategies.
// The precision of the result is 1 decimal place.

result = Math.Round(-3.45m, 1, MidpointRounding.ToEven);
Console.WriteLine($"{result} = Math.Round({-3.45m}, 1, MidpointRounding.ToEven)");
result = Math.Round(-3.45m, 1, MidpointRounding.AwayFromZero);
Console.WriteLine($"{result} = Math.Round({-3.45m}, 1, MidpointRounding.AwayFromZero)");
result = Math.Round(-3.47m, 1, MidpointRounding.ToZero);
Console.WriteLine($"{result} = Math.Round({-3.47m}, 1, MidpointRounding.ToZero)\n");

/*
This code example produces the following results:

3.4 = Math.Round(3.45, 1, MidpointRounding.ToEven)
3.5 = Math.Round(3.45, 1, MidpointRounding.AwayFromZero)
3.4 = Math.Round(3.47, 1, MidpointRounding.ToZero)

-3.4 = Math.Round(-3.45, 1, MidpointRounding.ToEven)
-3.5 = Math.Round(-3.45, 1, MidpointRounding.AwayFromZero)
-3.4 = Math.Round(-3.47, 1, MidpointRounding.ToZero)
*/

Comentários

Para obter mais informações sobre essa API, consulte Comentários da API complementar para MidpointRounding.

Aplica-se a

Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0