Guid.ToByteArray Méthode

Définition

Espace de noms:

System

Assembly:

System.Runtime.dll

Assembly:

mscorlib.dll

Assembly:

netstandard.dll

Retourne un tableau d'octets à 16 éléments qui contient la valeur de cette instance.

public:
 cli::array <System::Byte> ^ ToByteArray();

public byte[] ToByteArray ();

member this.ToByteArray : unit -> byte[]

Public Function ToByteArray () As Byte()

Retours

Byte[]

Tableau d'octets à 16 éléments.

Exemples

L’exemple suivant appelle la NewGuid méthode pour créer une Guid valeur, puis appelle la ToByteArray méthode pour représenter la Guid valeur en tant que tableau d’octets. Elle affiche ensuite les deux valeurs dans la console. Enfin, il instancie une nouvelle Guid valeur à partir du tableau d’octets et appelle sa Equals(Guid) méthode pour montrer que les deux Guid valeurs sont identiques.

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)

let guid = Guid.NewGuid()
printfn $"Guid: {guid}"
let bytes = guid.ToByteArray()
for byte in bytes do
    printf $"{byte:X2} "
printfn ""

let guid2 = Guid bytes
printfn $"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)

Remarques

Vous pouvez utiliser le tableau d’octets retourné par cette méthode pour aller-retour sur une Guid valeur en appelant le Guid(Byte[]) constructeur.

Notez que l’ordre des octets dans le tableau d’octets retourné est différent de la représentation sous forme de chaîne d’une Guid valeur. L’ordre du groupe de quatre octets début et les deux groupes à deux octets suivants est inversé, tandis que l’ordre du dernier groupe à deux octets et le groupe de six octets fermant est le même. Cet exemple en fournit une illustration.