Guid.ToByteArray Método

Definição

Espaço de Nomes:

System

Assemblagens:

netstandard.dll, System.Runtime.dll

Sobrecargas

Name	Descrição
ToByteArray(Boolean)
ToByteArray()	Devolve um array de 16 bytes que contém o valor desta instância.

ToByteArray(Boolean)

Origem:

Guid.cs

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

public byte[] ToByteArray(bool bigEndian);

member this.ToByteArray : bool -> byte[]

Public Function ToByteArray (bigEndian As Boolean) As Byte()

Parâmetros

bigEndian

Boolean

Devoluções

Byte[]

ToByteArray()

Origem:

Guid.cs

Devolve um array de 16 bytes que contém o valor desta instância.

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

public byte[] ToByteArray();

member this.ToByteArray : unit -> byte[]

Public Function ToByteArray () As Byte()

Devoluções

Byte[]

Um array de 16 bytes elementos.

Exemplos

O exemplo seguinte chama o NewGuid método para criar um Guid valor e depois chama o ToByteArray método para representar o Guid valor como um array de bytes. Depois, mostra ambos os valores para a consola. Finalmente, instancia um novo Guid valor do array de bytes e chama o seu Equals(Guid) método para mostrar que os dois Guid valores são idênticos.

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)

Observações

Pode usar o array de bytes devolvido por este método para fazer round-trip a um Guid valor chamando o Guid(Byte[]) construtor.

Note-se que a ordem dos bytes no array de bytes devolvidos é diferente da representação da cadeia de um Guid valor. A ordem do grupo inicial de quatro bytes e dos dois grupos seguintes de dois bytes é invertida, enquanto a ordem do último grupo de dois bytes e do grupo final de seis bytes é a mesma. O exemplo fornece uma ilustração.