Guid Constructores

Definición

Espacio de nombres:
System
Ensamblados:
mscorlib.dll, System.Runtime.dll
Ensamblados:
netstandard.dll, System.Runtime.dll
Ensamblado:
System.Runtime.dll
Ensamblado:
mscorlib.dll
Ensamblado:
netstandard.dll

Inicializa una nueva instancia de la Guid estructura.

Sobrecargas

Nombre Description
Guid(Byte[])

Inicializa una nueva instancia de la Guid estructura mediante la matriz especificada de bytes.
Guid(ReadOnlySpan<Byte>)

Inicializa una nueva instancia de la Guid estructura mediante el valor representado por el intervalo de bytes de solo lectura especificado.
Guid(String)

Inicializa una nueva instancia de la Guid estructura utilizando el valor representado por la cadena especificada.
Guid(ReadOnlySpan<Byte>, Boolean)

Inicializa una nueva instancia de la Guid estructura utilizando el valor representado por el intervalo de bytes de solo lectura especificado y la endianidad especificada.
Guid(Int32, Int16, Int16, Byte[])

Inicializa una nueva instancia de la Guid estructura mediante los enteros y la matriz de bytes especificados.
Guid(Int32, Int16, Int16, Byte, Byte, Byte, Byte, Byte, Byte, Byte, Byte)

Inicializa una nueva instancia de la Guid estructura mediante los enteros y bytes especificados.
Guid(UInt32, UInt16, UInt16, Byte, Byte, Byte, Byte, Byte, Byte, Byte, Byte)

Inicializa una nueva instancia de la Guid estructura mediante los enteros y bytes sin signo especificados.

Guid(Byte[])

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

Inicializa una nueva instancia de la Guid estructura mediante la matriz especificada de bytes.

public:
 Guid(cli::array <System::Byte> ^ b);
public Guid(byte[] b);
new Guid : byte[] -> Guid
Public Sub New (b As Byte())

Parámetros

b
Byte[]

Matriz de bytes de 16 elementos que contiene valores con los que inicializar el GUID.

Excepciones

ArgumentNullException

b es null.

ArgumentException

b no tiene 16 bytes de longitud.

Se aplica a

Guid(ReadOnlySpan<Byte>)

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

Inicializa una nueva instancia de la Guid estructura mediante el valor representado por el intervalo de bytes de solo lectura especificado.

public:
 Guid(ReadOnlySpan<System::Byte> b);
public Guid(ReadOnlySpan<byte> b);
new Guid : ReadOnlySpan<byte> -> Guid
Public Sub New (b As ReadOnlySpan(Of Byte))

Parámetros

b
ReadOnlySpan<Byte>

Intervalo de solo lectura que contiene los bytes que representan el GUID. El intervalo debe tener exactamente 16 bytes de longitud.

Excepciones

ArgumentException

El intervalo debe tener exactamente 16 bytes de longitud.

Se aplica a

Guid(String)

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

Inicializa una nueva instancia de la Guid estructura utilizando el valor representado por la cadena especificada.

public:
 Guid(System::String ^ g);
public Guid(string g);
new Guid : string -> Guid
Public Sub New (g As String)

Parámetros

g
String

Cadena que contiene un GUID en uno de los siguientes formatos ("d" representa un dígito hexadecimal cuyo caso se omite):

32 dígitos hexadecimales contiguos:

dddd

-o bien-

Grupos de 8, 4, 4, 4 y 12 dígitos hexadecimales con guiones entre los grupos. El GUID completo se puede incluir opcionalmente entre llaves o paréntesis coincidentes:

ddd-dddd-dddd-dd-d

-o bien-

{ddd-dddd-dd-dd-d-dd}

-o bien-

(dddd-dddd-dddd-d-dddd-d)

-o bien-

Grupos de 8, 4 y 4 dígitos hexadecimales, y un subconjunto de ocho grupos de 2 dígitos hexadecimales, con cada grupo con el prefijo "0x" o "0X" y separados por comas. El GUID completo, así como el subconjunto, se incluye entre llaves coincidentes:

{0xdddddddd, 0xdddd, 0xdddd,{0xdd,0xdd,0xdd,0xdd,0xdd,0xdd,0xdd,0xdd}}

Se requieren todas las llaves, comas y prefijos "0x". Se omiten todos los espacios incrustados. Se omiten todos los ceros iniciales de un grupo.

Los dígitos hexadecimales que se muestran en un grupo son el número máximo de dígitos hexadecimales significativos que pueden aparecer en ese grupo. Puede especificar de 1 al número de dígitos hexadecimales que se muestran para un grupo. Se supone que los dígitos especificados son los dígitos de orden inferior del grupo.

Excepciones

ArgumentNullException

g es null.

FormatException

El formato de g no es válido.

OverflowException

El formato de g no es válido.

Ejemplos

En el ejemplo siguiente se pasa cada cadena que aparece en la sección Comentarios al Guid(String) constructor.

string[] guidStrings = { "ca761232ed4211cebacd00aa0057b223",
                         "CA761232-ED42-11CE-BACD-00AA0057B223",
                         "{CA761232-ED42-11CE-BACD-00AA0057B223}",
                         "(CA761232-ED42-11CE-BACD-00AA0057B223)",
                         "{0xCA761232, 0xED42, 0x11CE, {0xBA, 0xCD, 0x00, 0xAA, 0x00, 0x57, 0xB2, 0x23}}" };
foreach (var guidString in guidStrings)
{
    var guid = new Guid(guidString);
    Console.WriteLine($"Original string: {guidString}");
    Console.WriteLine($"Guid:            {guid}");
    Console.WriteLine();
}

// The example displays the following output:
//    Original string: ca761232ed4211cebacd00aa0057b223
//    Guid:            ca761232-ed42-11ce-bacd-00aa0057b223
//
//    Original string: CA761232-ED42-11CE-BACD-00AA0057B223
//    Guid:            ca761232-ed42-11ce-bacd-00aa0057b223
//
//    Original string: {CA761232-ED42-11CE-BACD-00AA0057B223}
//    Guid:            ca761232-ed42-11ce-bacd-00aa0057b223
//
//    Original string: (CA761232-ED42-11CE-BACD-00AA0057B223)
//    Guid:            ca761232-ed42-11ce-bacd-00aa0057b223
//
//    Original string: {0xCA761232, 0xED42, 0x11CE, {0xBA, 0xCD, 0x00, 0xAA, 0x00, 0x57, 0xB2, 0x23}}
//    Guid:            ca761232-ed42-11ce-bacd-00aa0057b223

open System

let guidStrings =
    [ "ca761232ed4211cebacd00aa0057b223"
      "CA761232-ED42-11CE-BACD-00AA0057B223"
      "{CA761232-ED42-11CE-BACD-00AA0057B223}"
      "(CA761232-ED42-11CE-BACD-00AA0057B223)"
      "{0xCA761232, 0xED42, 0x11CE, {0xBA, 0xCD, 0x00, 0xAA, 0x00, 0x57, 0xB2, 0x23}}" ]

for guidString in guidStrings do
    let guid = Guid guidString
    printfn $"Original string: {guidString}"
    printfn $"Guid:            {guid}\n"

// The example displays the following output:
//    Original string: ca761232ed4211cebacd00aa0057b223
//    Guid:            ca761232-ed42-11ce-bacd-00aa0057b223
//
//    Original string: CA761232-ED42-11CE-BACD-00AA0057B223
//    Guid:            ca761232-ed42-11ce-bacd-00aa0057b223
//
//    Original string: {CA761232-ED42-11CE-BACD-00AA0057B223}
//    Guid:            ca761232-ed42-11ce-bacd-00aa0057b223
//
//    Original string: (CA761232-ED42-11CE-BACD-00AA0057B223)
//    Guid:            ca761232-ed42-11ce-bacd-00aa0057b223
//
//    Original string: {0xCA761232, 0xED42, 0x11CE, {0xBA, 0xCD, 0x00, 0xAA, 0x00, 0x57, 0xB2, 0x23}}
//    Guid:            ca761232-ed42-11ce-bacd-00aa0057b223

Module Example
   Public Sub Main()
      Dim guidStrings() As String = { "ca761232ed4211cebacd00aa0057b223",
                                      "CA761232-ED42-11CE-BACD-00AA0057B223", 
                                      "{CA761232-ED42-11CE-BACD-00AA0057B223}", 
                                      "(CA761232-ED42-11CE-BACD-00AA0057B223)", 
                                      "{0xCA761232, 0xED42, 0x11CE, {0xBA, 0xCD, 0x00, 0xAA, 0x00, 0x57, 0xB2, 0x23}}" }
      For Each guidString In guidStrings
         Dim guid As New Guid(guidString)
         Console.WriteLine("Original string: {0}", guidString)
         Console.WriteLine("Guid:            {0}", guid)
         Console.WriteLine()
      Next
   End Sub
End Module
' The example displays the following output:
'    Original string: ca761232ed4211cebacd00aa0057b223
'    Guid:            ca761232-ed42-11ce-bacd-00aa0057b223
'    
'    Original string: CA761232-ED42-11CE-BACD-00AA0057B223
'    Guid:            ca761232-ed42-11ce-bacd-00aa0057b223
'    
'    Original string: {CA761232-ED42-11CE-BACD-00AA0057B223}
'    Guid:            ca761232-ed42-11ce-bacd-00aa0057b223
'    
'    Original string: (CA761232-ED42-11CE-BACD-00AA0057B223)
'    Guid:            ca761232-ed42-11ce-bacd-00aa0057b223
'    
'    Original string: {0xCA761232, 0xED42, 0x11CE, {0xBA, 0xCD, 0x00, 0xAA, 0x00, 0x57, 0xB2, 0x23}}
'    Guid:            ca761232-ed42-11ce-bacd-00aa0057b223

Comentarios

Los dígitos hexadecimales alfabéticos del g parámetro pueden estar en mayúsculas o minúsculas. Por ejemplo, las cadenas siguientes representan el mismo GUID:

"ca761232ed4211cebacd00aa0057b223"

"CA761232-ED42-11CE-BACD-00AA0057B223"

"{CA761232-ED42-11CE-BACD-00AA0057B223}"

"(CA761232-ED42-11CE-BACD-00AA0057B223)"

"{0xCA761232, 0xED42, 0x11CE, {0xBA, 0xCD, 0x00, 0xAA, 0x00, 0x57, 0xB2, 0x23}}"

Se aplica a

Guid(ReadOnlySpan<Byte>, Boolean)

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

Inicializa una nueva instancia de la Guid estructura utilizando el valor representado por el intervalo de bytes de solo lectura especificado y la endianidad especificada.

public:
 Guid(ReadOnlySpan<System::Byte> b, bool bigEndian);
public Guid(ReadOnlySpan<byte> b, bool bigEndian);
new Guid : ReadOnlySpan<byte> * bool -> Guid
Public Sub New (b As ReadOnlySpan(Of Byte), bigEndian As Boolean)

Parámetros

b
ReadOnlySpan<Byte>

Intervalo de solo lectura de 16 elementos que contiene los bytes con los que inicializar el GUID.

bigEndian
Boolean

true para interpretar b como big-endian; false para interpretarlo como little-endian.

Excepciones

ArgumentException

b no tiene 16 bytes de longitud.

Se aplica a

Guid(Int32, Int16, Int16, Byte[])

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

Inicializa una nueva instancia de la Guid estructura mediante los enteros y la matriz de bytes especificados.

public:
 Guid(int a, short b, short c, cli::array <System::Byte> ^ d);
public Guid(int a, short b, short c, byte[] d);
new Guid : int * int16 * int16 * byte[] -> Guid
Public Sub New (a As Integer, b As Short, c As Short, d As Byte())

Parámetros

a
Int32

Los primeros 4 bytes del GUID.

b
Int16

Los siguientes 2 bytes del GUID.

c
Int16

Los siguientes 2 bytes del GUID.

d
Byte[]

Los 8 bytes restantes del GUID.

Excepciones

ArgumentNullException

d es null.

ArgumentException

d no tiene 8 bytes de longitud.

Ejemplos

Guid(1,2,3,new byte[]{0,1,2,3,4,5,6,7}) crea un Guid que corresponde a "00000001-0002-0003-0001-020304050607".

Se aplica a

Guid(Int32, Int16, Int16, Byte, Byte, Byte, Byte, Byte, Byte, Byte, Byte)

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

Inicializa una nueva instancia de la Guid estructura mediante los enteros y bytes especificados.

public:
 Guid(int a, short b, short c, System::Byte d, System::Byte e, System::Byte f, System::Byte g, System::Byte h, System::Byte i, System::Byte j, System::Byte k);
public Guid(int a, short b, short c, byte d, byte e, byte f, byte g, byte h, byte i, byte j, byte k);
new Guid : int * int16 * int16 * byte * byte * byte * byte * byte * byte * byte * byte -> Guid
Public Sub New (a As Integer, b As Short, c As Short, d As Byte, e As Byte, f As Byte, g As Byte, h As Byte, i As Byte, j As Byte, k As Byte)

Parámetros

a
Int32

Los primeros 4 bytes del GUID.

b
Int16

Los siguientes 2 bytes del GUID.

c
Int16

Los siguientes 2 bytes del GUID.

d
Byte

El siguiente byte del GUID.

e
Byte

El siguiente byte del GUID.

f
Byte

El siguiente byte del GUID.

g
Byte

El siguiente byte del GUID.

h
Byte

El siguiente byte del GUID.

i
Byte

El siguiente byte del GUID.

j
Byte

El siguiente byte del GUID.

k
Byte

El siguiente byte del GUID.

Ejemplos

En el ejemplo siguiente se crea un GUID cuya representación de cadena es "0000000a-000b-000c-0001-020304050607".

var g = new Guid(0xA, 0xB, 0xC,
                  new Byte[] { 0, 1, 2, 3, 4, 5, 6, 7 } );
Console.WriteLine($"{g:B}");

// The example displays the following output:
//        {0000000a-000b-000c-0001-020304050607}

open System

let g = Guid(0xA, 0xBs, 0xCs, [| 0uy..7uy |])
printfn $"{g:B}"

// The example displays the following output:
//        {0000000a-000b-000c-0001-020304050607}

Module Example
   Public Sub Main()
      Dim g As New Guid(&hA, &hB, &hC, 
                        New Byte() { 0, 1, 2, 3, 4, 5, 6, 7 } )
      Console.WriteLine("{0:B}", g)
   End Sub
End Module
' The example displays the following output:
'   {0000000a-000b-000c-0001-020304050607}

Comentarios

Especificar bytes individuales de esta manera se puede usar para eludir restricciones de orden de bytes (big-endian o orden de bytes little-endian) en determinados tipos de equipos.

Se aplica a

Guid(UInt32, UInt16, UInt16, Byte, Byte, Byte, Byte, Byte, Byte, Byte, Byte)

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

Importante

Esta API no es conforme a CLS.

Inicializa una nueva instancia de la Guid estructura mediante los enteros y bytes sin signo especificados.

public:
 Guid(System::UInt32 a, System::UInt16 b, System::UInt16 c, System::Byte d, System::Byte e, System::Byte f, System::Byte g, System::Byte h, System::Byte i, System::Byte j, System::Byte k);
[System.CLSCompliant(false)]
public Guid(uint a, ushort b, ushort c, byte d, byte e, byte f, byte g, byte h, byte i, byte j, byte k);
[<System.CLSCompliant(false)>]
new Guid : uint32 * uint16 * uint16 * byte * byte * byte * byte * byte * byte * byte * byte -> Guid
Public Sub New (a As UInteger, b As UShort, c As UShort, d As Byte, e As Byte, f As Byte, g As Byte, h As Byte, i As Byte, j As Byte, k As Byte)

Parámetros

a
UInt32

Los primeros 4 bytes del GUID.

b
UInt16

Los siguientes 2 bytes del GUID.

c
UInt16

Los siguientes 2 bytes del GUID.

d
Byte

El siguiente byte del GUID.

e
Byte

El siguiente byte del GUID.

f
Byte

El siguiente byte del GUID.

g
Byte

El siguiente byte del GUID.

h
Byte

El siguiente byte del GUID.

i
Byte

El siguiente byte del GUID.

j
Byte

El siguiente byte del GUID.

k
Byte

El siguiente byte del GUID.

Atributos
CLSCompliantAttribute

Comentarios

Al especificar los bytes de esta manera, se evitan problemas de endianidad.

Se aplica a