Guid.ToByteArray Methode

Definition

Gibt ein aus 16 Elementen bestehendes Bytearray zurück, das den Wert dieser Instanz enthält.Returns a 16-element byte array that contains the value of this instance.

public:
 cli::array <System::Byte> ^ ToByteArray();
public byte[] ToByteArray ();
member this.ToByteArray : unit -> byte[]
Public Function ToByteArray () As Byte()

Gibt zurück

Byte[]

Ein aus 16 Elementen bestehendes Bytearray.A 16-element byte array.

Beispiele

Im folgenden Beispiel wird die NewGuid-Methode aufgerufen, um einen Guid Wert zu erstellen. Anschließend wird die ToByteArray-Methode aufgerufen, um den Guid Wert als Bytearray darzustellen.The following example calls the NewGuid method to create a Guid value, and then calls the ToByteArray method to represent the Guid value as a byte array. Anschließend werden beide Werte in der Konsole angezeigt.It then displays both values to the console. Schließlich wird ein neuer Guid Wert aus dem Bytearray instanziiert und seine Equals(Guid)-Methode aufgerufen, um anzuzeigen, dass die beiden Guid Werte identisch sind.Finally, it instantiates a new Guid value from the byte array and calls its Equals(Guid) method to show that the two Guid values are identical.

Guid guid = Guid.NewGuid();
Console.WriteLine($"Guid: {guid}");
var bytes = guid.ToByteArray();
foreach (var byt in bytes)
    Console.Write($"{byt:X2} ");

Console.WriteLine();
var guid2 = new Guid(bytes);
Console.WriteLine($"Guid: {guid2} (Same as First Guid: {guid2.Equals(guid)})");

// The example displays output similar to the following:
//
//    Guid: 35918bc9-196d-40ea-9779-889d79b753f0
//    C9 8B 91 35 6D 19 EA 40 97 79 88 9D 79 B7 53 F0
//    Guid: 35918bc9-196d-40ea-9779-889d79b753f0 (Same as First Guid: True)
Module Example
   Public Sub Main()
      Dim guid As Guid = Guid.NewGuid
      Console.WriteLine("Guid: {0}", guid)
      Dim bytes() As Byte = guid.ToByteArray
      For Each byt In bytes
         Console.Write("{0:X2} ", byt)
      Next
      Console.WriteLine()
      Dim guid2 As New Guid(bytes)
      Console.WriteLine("Guid: {0} (Same as First Guid: {1})", guid2, guid2.Equals(guid))
   End Sub
End Module
' The example displays the following output:
'    Guid: 35918bc9-196d-40ea-9779-889d79b753f0
'    C9 8B 91 35 6D 19 EA 40 97 79 88 9D 79 B7 53 F0
'    Guid: 35918bc9-196d-40ea-9779-889d79b753f0 (Same as First Guid: True)

Hinweise

Sie können das Bytearray verwenden, das von dieser Methode zurückgegeben wird, um einen Guid Wert durch Aufrufen des Guid(Byte[])-Konstruktors zu durchlaufen.You can use the byte array returned by this method to round-trip a Guid value by calling the Guid(Byte[]) constructor.

Beachten Sie, dass die Reihenfolge der Bytes im zurückgegebenen Bytearray von der Zeichen folgen Darstellung eines Guid Werts abweicht.Note that the order of bytes in the returned byte array is different from the string representation of a Guid value. Die Reihenfolge der ersten vier-Byte-Gruppen und der nächsten 2 2-Byte-Gruppen wird umgekehrt, wohingegen die Reihenfolge der letzten zwei-Byte-Gruppe und der schließenden Six-Byte-Gruppe identisch ist.The order of the beginning four-byte group and the next two two-byte groups is reversed, whereas the order of the last two-byte group and the closing six-byte group is the same. Dies wird im Beispiel veranschaulicht.The example provides an illustration.

Gilt für: