Decimal.ToByte(Decimal) Método

Definição

Namespace:

System

Assembly:

System.Runtime.dll

Origem:

Decimal.cs

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

public:
 static System::Byte ToByte(System::Decimal value);

public static byte ToByte (decimal value);

static member ToByte : decimal -> byte

Public Shared Function ToByte (value As Decimal) As Byte

Parâmetros

value

Decimal

O número decimal a ser convertido.

Retornos

Byte

Um inteiro sem sinal de 8 bits equivalente a value.

Exceções

OverflowException

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

open System

let values = 
    [ 123m; Decimal(78000, 0, 0, false, 3uy)
      78.999m; 255.999m; 256m
      127.999m; 128m; -0.999m
      -1m; -128.999m; -129m ]

for value in values do
    try
        let number = Decimal.ToByte value
        printfn $"{value} --> {number}"
    with :? OverflowException as e ->
        printfn $"{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

Module Example
   Public Sub Main()
      Dim values() As Decimal = { 78d, New Decimal(78000, 0, 0, false, 3), 
                                  78.999d, 255.999d, 256d,
                                  127.999d, 128d, -0.999d, 
                                  -1d,  -128.999d, -129d }

      For Each value In values
         Try
            Dim number As Byte = Decimal.ToByte(value)
            Console.WriteLine("{0} --> {1}", value, number)       
         Catch e As OverflowException
             Console.WriteLine("{0}: {1}", e.GetType().Name, value)
         End Try   
      Next
   End Sub
End Module
' 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.

Confira também

• Byte