Guid.ToByteArray Method

Definition

Overloads

ToByteArray(Boolean)
ToByteArray()

Returns a 16-element byte array that contains the value of this instance.

ToByteArray(Boolean)

Source:
Guid.cs
Source:
Guid.cs
C#
public byte[] ToByteArray(bool bigEndian);

Parameters

bigEndian
Boolean

Returns

Byte[]

Applies to

.NET 10 i druge verzije
Proizvod Verzije
.NET 8, 9, 10

ToByteArray()

Source:
Guid.cs
Source:
Guid.cs
Source:
Guid.cs

Returns a 16-element byte array that contains the value of this instance.

C#
public byte[] ToByteArray();

Returns

Byte[]

A 16-element byte array.

Examples

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. It then displays both values to the console. 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.

C#
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)

Remarks

You can use the byte array returned by this method to round-trip a Guid value by calling the Guid(Byte[]) constructor.

Note that the order of bytes in the returned byte array is different from the string representation of a Guid value. 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. The example provides an illustration.

Applies to

.NET 10 i druge verzije
Proizvod Verzije
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0