Decimal.ToByte(Decimal) Decimal.ToByte(Decimal) Decimal.ToByte(Decimal) Decimal.ToByte(Decimal) Method

Definition

Konvertiert den Wert des angegebenen Decimal in die entsprechende 8-Bit-Ganzzahl ohne Vorzeichen.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

Parameter

value
Decimal Decimal Decimal Decimal

Die zu konvertierende Dezimalzahl.The decimal number to convert.

Gibt zurück

Eine 8-Bit-Ganzzahl ohne Vorzeichen, die value entspricht.An 8-bit unsigned integer equivalent to value.

Ausnahmen

value ist kleiner als MinValue oder größer als MaxValue.value is less than MinValue or greater than MaxValue.

Beispiele

Im folgenden Beispiel wird die ToByte Methode zum Konvertieren von Dezimalzahlen, Byte Werte.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

Hinweise

Parameter value wird gerundet, um den nächsten ganzzahligen Wert in Richtung 0 (null), und dieses Ergebnis wird zurückgegeben.Parameter value is rounded to the nearest integer value toward zero, and that result is returned.

Sie können auch konvertieren eine Decimal Wert in eine 8-Bit-Ganzzahl ohne Vorzeichen mithilfe der Explicit Zuweisungsoperator.You can also convert a Decimal value to an 8-bit unsigned integer by using the Explicit assignment operator. Da der Operator eine einschränkende Konvertierung ausführt, müssen Sie einen Typumwandlungsoperator in c# oder eine Konvertierungsfunktion in Visual Basic verwenden.Because the operator performs a narrowing conversion, you must use a casting operator in C# or a conversion function in Visual Basic.

Gilt für:

Siehe auch