Ler em inglês

Compartilhar via


Decimal.ToByte(Decimal) Método

Definição

Converte o valor do Decimal especificado no inteiro sem sinal de 8 bits equivalente.

public static byte ToByte (decimal value);

Parâmetros

value
Decimal

O número decimal a ser convertido.

Retornos

Um inteiro sem sinal de 8 bits equivalente a value.

Exceções

value é menor que Byte.MinValue ou maior que Byte.MaxValue.

Exemplos

O exemplo a seguir usa o ToByte método para converter números decimais em Byte valores.

using System;

class Example
{
   public static void Main( )
   {
      decimal[] values = { 123m, new Decimal(78000, 0, 0, false, 3),
                           78.999m, 255.999m, 256m,
                           127.999m, 128m, -0.999m,
                           -1m,  -128.999m, -129m };

      foreach (var value in values) {
         try {
            byte number = Decimal.ToByte(value);
            Console.WriteLine("{0} --> {1}", value, number);
         }
         catch (OverflowException e)
         {
             Console.WriteLine("{0}: {1}", e.GetType().Name, value);
         }
      }
   }
}
// The example displays the following output:
//     78 --> 78
//     78.000 --> 78
//     78.999 --> 78
//     255.999 --> 255
//     OverflowException: 256
//     127.999 --> 127
//     128 --> 128
//     -0.999 --> 0
//     OverflowException: -1
//     OverflowException: -128.999
//     OverflowException: -129

Comentários

O parâmetro value é arredondado para o valor inteiro mais próximo em direção a zero e esse resultado é retornado.

Você também pode converter um Decimal valor em um inteiro sem sinal de 8 bits usando o Explicit operador de atribuição. Como o operador executa uma conversão de restrição, você deve usar um operador de conversão em C# ou uma função de conversão no Visual Basic.

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 1.1, 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

Confira também