Guid.ToByteArray Método

Referência

Definição

Namespace:: System

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Retorna uma matriz de bytes de 16 elementos que contém o valor dessa instância.

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

public byte[] ToByteArray ();

member this.ToByteArray : unit -> byte[]

Public Function ToByteArray () As Byte()

Retornos

Byte[]

Uma matriz de bytes de 16 elementos.

Exemplos

O exemplo a seguir chama o NewGuid método para criar um Guid valor e chama o ToByteArray método para representar o Guid valor como uma matriz de bytes. Em seguida, ele exibe os dois valores no console. Por fim, ele cria uma instância de um novo Guid valor da matriz de bytes e chama 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)

Comentários

Você pode usar a matriz de bytes retornada por esse método para arredondar um Guid valor chamando o Guid(Byte[]) construtor.

Observe que a ordem dos bytes na matriz de bytes retornada é diferente da representação de cadeia de caracteres de um Guid valor. A ordem do grupo de quatro bytes inicial e dos dois próximos grupos de dois bytes é invertida, enquanto a ordem do último grupo de dois bytes e o grupo de seis bytes de fechamento é a mesma. O exemplo fornece uma ilustração.

Aplica-se a

Compartilhar via