BitConverter Klasse

Definition

public ref class BitConverter abstract sealed

public ref class BitConverter sealed

public static class BitConverter

public sealed class BitConverter

type BitConverter = class

Public Class BitConverter

Public NotInheritable Class BitConverter

Vererbung

Object

BitConverter

Beispiele

Im folgenden Codebeispiel wird die Verwendung mehrerer BitConverter Klassenmethoden veranschaulicht.

// Example of BitConverter class methods.
using namespace System;
int main()
{
   String^ formatter = "{0,25}{1,30}";
   double aDoubl = 0.1111111111111111111;
   float aSingl = 0.1111111111111111111F;
   __int64 aLong = 1111111111111111111;
   int anInt = 1111111111;
   short aShort = 11111;
   __wchar_t aChar = L'*';
   bool aBool = true;
   Console::WriteLine( "This example of methods of the BitConverter class"
   "\ngenerates the following output.\n" );
   Console::WriteLine( formatter, "argument", "byte array" );
   Console::WriteLine( formatter, "--------", "----------" );
   
   // Convert values to Byte arrays and display them.
   Console::WriteLine( formatter, aDoubl, BitConverter::ToString( BitConverter::GetBytes( aDoubl ) ) );
   Console::WriteLine( formatter, aSingl, BitConverter::ToString( BitConverter::GetBytes( aSingl ) ) );
   Console::WriteLine( formatter, aLong, BitConverter::ToString( BitConverter::GetBytes( aLong ) ) );
   Console::WriteLine( formatter, anInt, BitConverter::ToString( BitConverter::GetBytes( anInt ) ) );
   Console::WriteLine( formatter, aShort, BitConverter::ToString( BitConverter::GetBytes( aShort ) ) );
   Console::WriteLine( formatter, aChar, BitConverter::ToString( BitConverter::GetBytes( aChar ) ) );
   Console::WriteLine( formatter, aBool, BitConverter::ToString( BitConverter::GetBytes( aBool ) ) );
}

/*
This example of methods of the BitConverter class
generates the following output.

                 argument                    byte array
                 --------                    ----------
        0.111111111111111       1C-C7-71-1C-C7-71-BC-3F
                0.1111111                   39-8E-E3-3D
      1111111111111111111       C7-71-C4-2B-AB-75-6B-0F
               1111111111                   C7-35-3A-42
                    11111                         67-2B
                        *                         2A-00
                     True                            01
*/

// Example of BitConverter class methods.
using System;

class BitConverterDemo
{
    public static void Main( )
    {
        const string formatter = "{0,25}{1,30}";

        double  aDoubl  = 0.1111111111111111111;
        float   aSingl  = 0.1111111111111111111F;
        long    aLong   = 1111111111111111111;
        int     anInt   = 1111111111;
        short   aShort  = 11111;
        char    aChar   = '*';
        bool    aBool   = true;

        Console.WriteLine(
            "This example of methods of the BitConverter class" +
            "\ngenerates the following output.\n" );
        Console.WriteLine( formatter, "argument", "byte array" );
        Console.WriteLine( formatter, "--------", "----------" );

        // Convert values to Byte arrays and display them.
        Console.WriteLine( formatter, aDoubl,
            BitConverter.ToString( BitConverter.GetBytes( aDoubl ) ) );
        Console.WriteLine( formatter, aSingl,
            BitConverter.ToString( BitConverter.GetBytes( aSingl ) ) );
        Console.WriteLine( formatter, aLong,
            BitConverter.ToString( BitConverter.GetBytes( aLong ) ) );
        Console.WriteLine( formatter, anInt,
            BitConverter.ToString( BitConverter.GetBytes( anInt ) ) );
        Console.WriteLine( formatter, aShort,
            BitConverter.ToString( BitConverter.GetBytes( aShort ) ) );
        Console.WriteLine( formatter, aChar,
            BitConverter.ToString( BitConverter.GetBytes( aChar ) ) );
        Console.WriteLine( formatter, aBool,
            BitConverter.ToString( BitConverter.GetBytes( aBool ) ) );
    }
}

/*
This example of methods of the BitConverter class
generates the following output.

                 argument                    byte array
                 --------                    ----------
        0.111111111111111       1C-C7-71-1C-C7-71-BC-3F
                0.1111111                   39-8E-E3-3D
      1111111111111111111       C7-71-C4-2B-AB-75-6B-0F
               1111111111                   C7-35-3A-42
                    11111                         67-2B
                        *                         2A-00
                     True                            01
*/

open System

let print: obj -> obj -> unit = printfn "%25O%30O"

let aDoubl = 0.1111111111111111111
let aSingl = 0.1111111111111111111f
let aLong = 1111111111111111111L
let anInt = 1111111111
let aShort = 11111s
let aChar = '*'
let aBool = true

printfn "This example of methods of the BitConverter class\ngenerates the following output.\n"
print "argument" "byte array"
print "--------" "----------"

// Convert values to Byte arrays and display them.
print aDoubl (BitConverter.ToString(BitConverter.GetBytes aDoubl))

print aSingl (BitConverter.ToString(BitConverter.GetBytes aSingl))

print aLong (BitConverter.ToString(BitConverter.GetBytes aLong))

print anInt (BitConverter.ToString(BitConverter.GetBytes anInt))

print aShort (BitConverter.ToString(BitConverter.GetBytes aShort))

print aChar (BitConverter.ToString(BitConverter.GetBytes aChar))

print aBool (BitConverter.ToString(BitConverter.GetBytes aBool))


// This example of methods of the BitConverter class
// generates the following output.
//
//                  argument                    byte array
//                  --------                    ----------
//         0.111111111111111       1C-C7-71-1C-C7-71-BC-3F
//                 0.1111111                   39-8E-E3-3D
//       1111111111111111111       C7-71-C4-2B-AB-75-6B-0F
//                1111111111                   C7-35-3A-42
//                     11111                         67-2B
//                         *                         2A-00
//                      True                            01

' Example of BitConverter class methods.
Module BitConverterDemo

    Sub Main( )

        Const formatter As String = "{0,25}{1,30}"
 
        Dim aDoubl      As Double   = 0.1111111111111111111
        Dim aSingl      As Single   = 0.1111111111111111111
        Dim aLong       As Long     = 1111111111111111111
        Dim anInt       As Integer  = 1111111111
        Dim aShort      As Short    = 11111
        Dim aChar       As Char     = "*"c
        Dim aBool       As Boolean  = True

        Console.WriteLine( _
            "This example of methods of the BitConverter class" & _
            vbCrLf & "generates the following output." & vbCrLf )
        Console.WriteLine( formatter, "argument", "Byte array" )
        Console.WriteLine( formatter, "--------", "----------" )

        ' Convert values to Byte arrays and display them.
        Console.WriteLine( formatter, aDoubl, _
            BitConverter.ToString( BitConverter.GetBytes( aDoubl ) ) )
        Console.WriteLine( formatter, aSingl, _
            BitConverter.ToString( BitConverter.GetBytes( aSingl ) ) )
        Console.WriteLine( formatter, aLong, _
            BitConverter.ToString( BitConverter.GetBytes( aLong ) ) )
        Console.WriteLine( formatter, anInt, _
            BitConverter.ToString( BitConverter.GetBytes( anInt ) ) )
        Console.WriteLine( formatter, aShort, _
            BitConverter.ToString( BitConverter.GetBytes( aShort ) ) )
        Console.WriteLine( formatter, aChar, _
            BitConverter.ToString( BitConverter.GetBytes( aChar ) ) )
        Console.WriteLine( formatter, aBool, _
            BitConverter.ToString( BitConverter.GetBytes( aBool ) ) )
    End Sub
End Module

' This example of methods of the BitConverter class
' generates the following output.
' 
'                  argument                    Byte array
'                  --------                    ----------
'         0.111111111111111       1C-C7-71-1C-C7-71-BC-3F
'                 0.1111111                   39-8E-E3-3D
'       1111111111111111111       C7-71-C4-2B-AB-75-6B-0F
'                1111111111                   C7-35-3A-42
'                     11111                         67-2B
'                         *                         2A-00
'                      True                            01

Hinweise

Die BitConverter Klasse hilft dabei, Werttypen in ihrer grundlegenden Form als Eine Reihe von Bytes zu bearbeiten. Ein Byte wird als eine 8-Bit-ganzzahl ohne Vorzeichen definiert. Die BitConverter Klasse enthält statische Methoden zum Konvertieren der einzelnen Grundtypen in und aus einem Bytearray, wie die folgende Tabelle veranschaulicht.

Wenn Sie BitConverter Methoden für Roundtripdaten verwenden, stellen Sie sicher, dass die GetBytes Überladung und die ToType-Methode denselben Typ angeben. Wie im folgenden Beispiel dargestellt, kann das Wiederherstellen eines Arrays, das eine signierte ganze Zahl darstellt, durch Aufrufen der ToUInt32-Methode zu einem Wert führen, der sich vom Ursprünglichen unterscheidet. Weitere Informationen finden Sie unter Arbeiten mit signierten nicht dezimalen und bitweisen Werten.

using System;

public class Example
{
   public static void Main()
   {
      int value = -16;
      Byte[] bytes = BitConverter.GetBytes(value);

      // Convert bytes back to int.
      int intValue = BitConverter.ToInt32(bytes, 0);
      Console.WriteLine("{0} = {1}: {2}",
                        value, intValue,
                        value.Equals(intValue) ? "Round-trips" : "Does not round-trip");
      // Convert bytes to UInt32.
      uint uintValue = BitConverter.ToUInt32(bytes, 0);
      Console.WriteLine("{0} = {1}: {2}", value, uintValue,
                        value.Equals(uintValue) ? "Round-trips" : "Does not round-trip");
   }
}
// The example displays the following output:
//       -16 = -16: Round-trips
//       -16 = 4294967280: Does not round-trip

open System

let value = -16
let bytes = BitConverter.GetBytes value

// Convert bytes back to int.
let intValue = BitConverter.ToInt32(bytes, 0)
printfn $"""{value} = {intValue}: {if value.Equals intValue then "Round-trips" else "Does not round-trip"}"""

// Convert bytes to UInt32.
let uintValue = BitConverter.ToUInt32(bytes, 0)
printfn $"""{value} = {uintValue}: {if value.Equals uintValue then "Round-trips" else "Does not round-trip"}"""


// The example displays the following output:
//       -16 = -16: Round-trips
//       -16 = 4294967280: Does not round-trip

Module Example
   Public Sub Main()
      Dim value As Integer = -16
      Dim bytes() As Byte = BitConverter.GetBytes(value) 
      
      ' Convert bytes back to Int32.
      Dim intValue As Integer = BitConverter.ToInt32(bytes, 0)
      Console.WriteLine("{0} = {1}: {2}", 
                        value, intValue, 
                        If(value.Equals(intValue), "Round-trips", "Does not round-trip"))
      ' Convert bytes to UInt32.
      Dim uintValue As UInteger = BitConverter.ToUInt32(bytes, 0)
      Console.WriteLine("{0} = {1}: {2}", value, uintValue, 
                        If(value.Equals(uintValue), "Round-trips", "Does not round-trip"))
   End Sub
End Module
' The example displays the following output:
'       -16 = -16: Round-trips
'       -16 = 4294967280: Does not round-trip

Die Reihenfolge der Byte im Array, das von den GetBytes Methodenüberladungen (sowie die Reihenfolge der Bits in der von der DoubleToInt64Bits Methode zurückgegebenen Ganzzahl) zurückgegeben wird, hängt davon ab, ob die Computerarchitektur little-endian oder big-endian ist. Ebenso hängt die Reihenfolge der Bytes im Array und von den ToIntegerValue- Methoden und der ToChar-Methode davon ab, ob die Computerarchitektur little-endian oder big-endian ist. Die Endianität einer Architektur wird durch die IsLittleEndian Eigenschaft angegeben, die true auf Little-End-Systemen zurückgibt und auf Big-End-Systemen false. Auf kleinen endischen Systemen gehen Bytes in niedrigerer Reihenfolge vor Byte höherer Reihenfolge vor. Auf big-endian system, higher-order bytes precede lower-order bytes. In der folgenden Tabelle wird der Unterschied in den Bytearrays veranschaulicht, die sich daraus ergeben, dass die ganze Zahl 1.234.567.890 (0x499602D2) an die GetBytes(Int32)-Methode übergeben wird. Die Bytes werden in der Reihenfolge des Bytes bei Index 0 bis zum Byte bei Index 3 aufgelistet.

Da der Rückgabewert einiger Methoden von der Systemarchitektur abhängt, achten Sie beim Übertragen von Bytedaten über computergrenzen hinweg:

• Wenn alle Systeme, die Daten senden und empfangen, garantiert die gleiche Endianität haben, muss nichts an den Daten vorgenommen werden.

• Wenn Systeme, die Daten senden und empfangen, unterschiedliche Endianität aufweisen können, übermitteln Sie daten immer in einer bestimmten Reihenfolge. Dies bedeutet, dass die Reihenfolge der Bytes im Array möglicherweise vor dem Senden oder nach dem Empfang umgekehrt werden muss. Eine gängige Konvention besteht darin, Daten in der Bytereihenfolge (Big-Endian-Reihenfolge) zu übertragen. Im folgenden Beispiel wird eine Implementierung zum Senden eines ganzzahligen Werts in der Bytereihenfolge des Netzwerks bereitgestellt.

  using System;
  
  public class Example
  {
     public static void Main()
     {
        int value = 12345678;
        byte[] bytes = BitConverter.GetBytes(value);
        Console.WriteLine(BitConverter.ToString(bytes));
  
        if (BitConverter.IsLittleEndian)
           Array.Reverse(bytes);
  
        Console.WriteLine(BitConverter.ToString(bytes));
        // Call method to send byte stream across machine boundaries.
  
        // Receive byte stream from beyond machine boundaries.
        Console.WriteLine(BitConverter.ToString(bytes));
        if (BitConverter.IsLittleEndian)
           Array.Reverse(bytes);
  
        Console.WriteLine(BitConverter.ToString(bytes));
        int result = BitConverter.ToInt32(bytes, 0);
        Console.WriteLine("Original value: {0}", value);
        Console.WriteLine("Returned value: {0}", result);
     }
  }
  // The example displays the following output on a little-endian system:
  //       4E-61-BC-00
  //       00-BC-61-4E
  //       00-BC-61-4E
  //       4E-61-BC-00
  //       Original value: 12345678
  //       Returned value: 12345678
  

  open System
  
  let value = 12345678
  let bytes = BitConverter.GetBytes value
  printfn $"{BitConverter.ToString bytes}"
  
  if BitConverter.IsLittleEndian then
      Array.Reverse bytes
  
  printfn $"{BitConverter.ToString bytes}"
  // Call method to send byte stream across machine boundaries.
  
  // Receive byte stream from beyond machine boundaries.
  printfn $"{BitConverter.ToString bytes}"
  if BitConverter.IsLittleEndian then
      Array.Reverse bytes
  
  printfn $"{BitConverter.ToString bytes}"
  let result = BitConverter.ToInt32(bytes, 0)
  
  printfn $"Original value: {value}"
  printfn $"Returned value: {result}"
  
  // The example displays the following output on a little-endian system:
  //       4E-61-BC-00
  //       00-BC-61-4E
  //       00-BC-61-4E
  //       4E-61-BC-00
  //       Original value: 12345678
  //       Returned value: 12345678
  

  Module Example
     Public Sub Main()
        Dim value As Integer = 12345678
        Dim bytes() As Byte = BitConverter.GetBytes(value)
        Console.WriteLine(BitConverter.ToString(bytes))
        
        If BitConverter.IsLittleEndian Then
           Array.Reverse(bytes) 
        End If
        Console.WriteLine(BitConverter.ToString(bytes))
        ' Call method to send byte stream across machine boundaries.
        
        ' Receive byte stream from beyond machine boundaries.
        Console.WriteLine(BitConverter.ToString(bytes))
        If BitConverter.IsLittleEndian Then     
           Array.Reverse(bytes)
        End If   
        Console.WriteLine(BitConverter.ToString(bytes))
        Dim result As Integer = BitConverter.ToInt32(bytes, 0)
        Console.WriteLine("Original value: {0}", value)
        Console.WriteLine("Returned value: {0}", result)
     End Sub
  End Module
  ' The example displays the following output on a little-endian system:
  '       4E-61-BC-00
  '       00-BC-61-4E
  '       00-BC-61-4E
  '       4E-61-BC-00
  '       Original value: 12345678
  '       Returned value: 12345678
  

• Wenn Systeme, die Daten senden und empfangen, unterschiedliche Endianität aufweisen können und die zu übertragenden Daten aus signierten Ganzzahlen bestehen, rufen Sie die IPAddress.HostToNetworkOrder Methode auf, um die Daten in die Netzwerkbytereihenfolge und die IPAddress.NetworkToHostOrder-Methode zu konvertieren, um sie in die vom Empfänger erforderliche Reihenfolge zu konvertieren.

Felder

Methoden

Gilt für:

Weitere Informationen

• Byte