Decimal.ToByte(Decimal) Метод

Определение

Преобразует значение заданного объекта типа Decimal в эквивалентное 8-разрядное целое число без знака.Converts the value of the specified Decimal to the equivalent 8-bit unsigned integer.

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

Параметры

value
Decimal

Десятичное число для преобразования.The decimal number to convert.

Возвраты

8-разрядное целое число без знака, эквивалентное value.An 8-bit unsigned integer equivalent to value.

Исключения

Значение value меньше MinValue или больше MaxValue.value is less than MinValue or greater than MaxValue.

Примеры

В следующем примере используется метод ToByte для преобразования десятичных чисел в Byte значения.The following example uses the ToByte method to convert decimal numbers to Byte values.

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

Комментарии

Параметр value округляется до ближайшего целого числа в сторону нуля, и возвращается результат.Parameter value is rounded to the nearest integer value toward zero, and that result is returned.

Можно также преобразовать Decimal значение в 8-битовое целое число без знака с помощью оператора присваивания Explicit.You can also convert a Decimal value to an 8-bit unsigned integer by using the Explicit assignment operator. Поскольку оператор выполняет понижающие преобразования, необходимо использовать оператор приведения в C# или функцию преобразования в Visual Basic.Because the operator performs a narrowing conversion, you must use a casting operator in C# or a conversion function in Visual Basic.

Применяется к

Дополнительно