Guid Constructores

  • Referencia

Definición

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

Inicializa una nueva instancia de la estructura Guid.

Sobrecargas

Guid(Byte[])

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

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

Inicializa una nueva instancia de la estructura Guid usando el valor representado por la cadena especificada.
Guid(ReadOnlySpan<Byte>, Boolean)
Guid(Int32, Int16, Int16, Byte[])

Inicializa una nueva instancia de la estructura Guid usando la matriz de enteros y bytes especificada.
Guid(Int32, Int16, Int16, Byte, Byte, Byte, Byte, Byte, Byte, Byte, Byte)

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

Inicializa una nueva instancia de la estructura Guid usando los enteros y bytes sin firmar especificados.

Guid(Byte[])

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

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

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 se va a inicializar el GUID.

Excepciones

ArgumentNullException

b es null.

ArgumentException

b no tiene una longitud de 16 bytes.

Se aplica a

Guid(ReadOnlySpan<Byte>)

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

Inicializa una nueva instancia de la estructura Guid usando 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

Inicializa una nueva instancia de la estructura Guid usando 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 identificador GUID en uno de los siguientes formatos ("d" representa un dígito hexadecimal sin distinción de mayúsculas y minúsculas):

32 dígitos hexadecimales contiguos:

dddddddddddddddddddddddddddddddd

O bien

Grupos de 8, 4, 4, 4 y 12 dígitos hexadecimales con guiones entre los grupos. Todo el identificador GUID puede encerrarse de forma opcional entre llaves o paréntesis:

dddddddd-dddd-dddd-dddd-dddddddddddd

O bien

{dddddddd-dddd-dddd-dddd-dddddddddddd}

O bien

(dddddddd-dddd-dddd-dddd-dddddddddddd)

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. Todo el identificador GUID, así como el subconjunto, se incluyen entre llaves:

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

Todas las llaves, las comas y los prefijos "0x" son necesarios. Todos los espacios incrustados se pasan por alto. 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. Los dígitos especificados se consideran 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 siguientes cadenas 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
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>
bigEndian
Boolean

Se aplica a

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

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

Inicializa una nueva instancia de la estructura Guid usando la matriz de enteros y bytes especificada.

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 cuatro primeros bytes del identificador exclusivo global (GUID).

b
Int16

Los dos bytes siguientes del identificador exclusivo global (GUID).

c
Int16

Los dos bytes siguientes del identificador exclusivo global (GUID).

d
Byte[]

Los ocho bytes restantes del identificador exclusivo global (GUID).

Excepciones

ArgumentNullException

d es null.

ArgumentException

d no tiene una longitud de 8 bytes.

Ejemplos

Guid(1,2,3,new byte[]{0,1,2,3,4,5,6,7}) crea un Guid objeto 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

Inicializa una nueva instancia de la estructura Guid usando 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 cuatro primeros bytes del identificador exclusivo global (GUID).

b
Int16

Los dos bytes siguientes del identificador exclusivo global (GUID).

c
Int16

Los dos bytes siguientes del identificador exclusivo global (GUID).

d
Byte

El byte siguiente del identificador exclusivo global (GUID).

e
Byte

El byte siguiente del identificador exclusivo global (GUID).

f
Byte

El byte siguiente del identificador exclusivo global (GUID).

g
Byte

El byte siguiente del identificador exclusivo global (GUID).

h
Byte

El byte siguiente del identificador exclusivo global (GUID).

i
Byte

El byte siguiente del identificador exclusivo global (GUID).

j
Byte

El byte siguiente del identificador exclusivo global (GUID).

k
Byte

El byte siguiente del identificador exclusivo global (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

La especificación de bytes individuales de esta manera se puede usar para eludir las restricciones de orden de bytes (big-endian o el 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

Importante

Esta API no es conforme a CLS.

Inicializa una nueva instancia de la estructura Guid usando los enteros y bytes sin firmar 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 cuatro primeros bytes del identificador exclusivo global (GUID).

b
UInt16

Los dos bytes siguientes del identificador exclusivo global (GUID).

c
UInt16

Los dos bytes siguientes del identificador exclusivo global (GUID).

d
Byte

El byte siguiente del identificador exclusivo global (GUID).

e
Byte

El byte siguiente del identificador exclusivo global (GUID).

f
Byte

El byte siguiente del identificador exclusivo global (GUID).

g
Byte

El byte siguiente del identificador exclusivo global (GUID).

h
Byte

El byte siguiente del identificador exclusivo global (GUID).

i
Byte

El byte siguiente del identificador exclusivo global (GUID).

j
Byte

El byte siguiente del identificador exclusivo global (GUID).

k
Byte

El byte siguiente del identificador exclusivo global (GUID).

Atributos
CLSCompliantAttribute

Comentarios

Si se especifican los bytes de esta manera, se evitan problemas de endianness.

Se aplica a