Guid Costruttori

Definizione

Inizializza una nuova istanza della struttura Guid.Initializes a new instance of the Guid structure.

Overload

Guid(Byte[])

Inizializza una nuova istanza della struttura Guid con la matrice di byte specificata.Initializes a new instance of the Guid structure by using the specified array of bytes.

Guid(ReadOnlySpan<Byte>)

Inizializza una nuova istanza della struttura Guid con il valore rappresentato dall'intervallo di byte di sola lettura specificato.Initializes a new instance of the Guid structure by using the value represented by the specified read-only span of bytes.

Guid(String)

Inizializza una nuova istanza della struttura Guid con il valore rappresentato dalla stringa specificata.Initializes a new instance of the Guid structure by using the value represented by the specified string.

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

Inizializza una nuova istanza della struttura Guid usando gli interi e la matrice di byte specificati.Initializes a new instance of the Guid structure by using the specified integers and byte array.

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

Inizializza una nuova istanza della struttura Guid usando gli interi e i byte specificati.Initializes a new instance of the Guid structure by using the specified integers and bytes.

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

Inizializza una nuova istanza della struttura Guid usando gli interi senza segno e i byte specificati.Initializes a new instance of the Guid structure by using the specified unsigned integers and bytes.

Guid(Byte[])

Inizializza una nuova istanza della struttura Guid con la matrice di byte specificata.Initializes a new instance of the Guid structure by using the specified array of bytes.

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

Parametri

b
Byte[]

Matrice di byte a 16 elementi contenente i valori con cui inizializzare il GUID.A 16-element byte array containing values with which to initialize the GUID.

Eccezioni

b è null.b is null.

b non ha una lunghezza di 16 byte.b is not 16 bytes long.

Guid(ReadOnlySpan<Byte>)

Inizializza una nuova istanza della struttura Guid con il valore rappresentato dall'intervallo di byte di sola lettura specificato.Initializes a new instance of the Guid structure by using the value represented by the specified read-only span of bytes.

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

Parametri

b
ReadOnlySpan<Byte>

Intervallo di sola lettura contenente i byte che rappresentano il GUID.A read-only span containing the bytes representing the GUID. L'intervallo deve avere una lunghezza esatta di 16 byte.The span must be exactly 16 bytes long.

Eccezioni

L'intervallo deve avere una lunghezza esatta di 16 byte.The span must be exactly 16 bytes long.

Guid(String)

Inizializza una nuova istanza della struttura Guid con il valore rappresentato dalla stringa specificata.Initializes a new instance of the Guid structure by using the value represented by the specified string.

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

Parametri

g
String

Stringa contenente un GUID in uno dei seguenti formati ("d" rappresenta una cifra esadecimale, senza distinzione tra maiuscole e minuscole):A string that contains a GUID in one of the following formats ("d" represents a hexadecimal digit whose case is ignored):

32 cifre contigue:32 contiguous digits:

dddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddddd

In alternativa-or-

Gruppi di 8, 4, 4, 4 e 12 cifre, separati da trattini.Groups of 8, 4, 4, 4, and 12 digits with hyphens between the groups. L'intero GUID può eventualmente essere racchiuso tra parentesi tonde o graffe:The entire GUID can optionally be enclosed in matching braces or parentheses:

dddddddd-dddd-dddd-dddd-dddddddddddddddddddd-dddd-dddd-dddd-dddddddddddd

-oppure--or-

{dddddddd-dddd-dddd-dddd-dddddddddddd}{dddddddd-dddd-dddd-dddd-dddddddddddd}

In alternativa-or-

(dddddddd-dddd-dddd-dddd-dddddddddddd)(dddddddd-dddd-dddd-dddd-dddddddddddd)

In alternativa-or-

Gruppi di 8, 4 e 4 cifre e un sottoinsieme di 8 gruppi di 2 cifre, ciascun gruppo con il prefisso "0x" o "0X" e separato da virgole.Groups of 8, 4, and 4 digits, and a subset of eight groups of 2 digits, with each group prefixed by "0x" or "0X", and separated by commas. Sia l'intero GUID che il sottoinsieme sono racchiusi tra parentesi graffe:The entire GUID, as well as the subset, is enclosed in matching braces:

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

Le parentesi, le virgole e i prefissi "0x" sono obbligatori.All braces, commas, and "0x" prefixes are required. Tutti gli spazi eventualmente incorporati vengono ignorati.All embedded spaces are ignored. Gli zeri iniziali di un gruppo vengono ignorati.All leading zeros in a group are ignored.

Le cifre visualizzate in un gruppo rappresentano il numero massimo di cifre significative che il gruppo può contenere.The digits shown in a group are the maximum number of meaningful digits that can appear in that group. È possibile specificare un numero di cifre compreso tra 1 e il numero di cifre visualizzate per un gruppo.You can specify from 1 to the number of digits shown for a group. Tali cifre vengono considerate come le cifre di base del gruppo.The specified digits are assumed to be the low-order digits of the group.

Eccezioni

g è null.g is null.

Il formato di g non è valido.The format of g is invalid.

Il formato di g non è valido.The format of g is invalid.

Esempi

Nell'esempio seguente ogni stringa elencata nella sezione Osservazioni viene passata al costruttore Guid(String).The following example passes each string listed in the Remarks section to the 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
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

Commenti

Le cifre esadecimali alfabetiche nel parametro g possono essere maiuscole o minuscole.The alphabetic hexadecimal digits in the g parameter can be uppercase or lowercase. Ad esempio, le stringhe seguenti rappresentano lo stesso GUID:For example, the following strings represent the same GUID:

"ca761232ed4211cebacd00aa0057b223""ca761232ed4211cebacd00aa0057b223"

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

"{CA761232-ED42-11CE-BACD-00AA0057B223}""{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}}""{0xCA761232, 0xED42, 0x11CE, {0xBA, 0xCD, 0x00, 0xAA, 0x00, 0x57, 0xB2, 0x23}}"

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

Inizializza una nuova istanza della struttura Guid usando gli interi e la matrice di byte specificati.Initializes a new instance of the Guid structure by using the specified integers and byte array.

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())

Parametri

a
Int32

Primi 4 byte del GUID.The first 4 bytes of the GUID.

b
Int16

I 2 byte successivi del GUID.The next 2 bytes of the GUID.

c
Int16

I 2 byte successivi del GUID.The next 2 bytes of the GUID.

d
Byte[]

Gli 8 byte rimanenti del GUID.The remaining 8 bytes of the GUID.

Eccezioni

d è null.d is null.

Il parametro d non è lungo 8 byte.d is not 8 bytes long.

Esempi

Guid(1,2,3,new byte[]{0,1,2,3,4,5,6,7}) crea un Guid che corrisponde a "00000001-0002-0003-0001-020304050607".Guid(1,2,3,new byte[]{0,1,2,3,4,5,6,7}) creates a Guid that corresponds to "00000001-0002-0003-0001-020304050607".

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

Inizializza una nuova istanza della struttura Guid usando gli interi e i byte specificati.Initializes a new instance of the Guid structure by using the specified integers and bytes.

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)

Parametri

a
Int32

Primi 4 byte del GUID.The first 4 bytes of the GUID.

b
Int16

I 2 byte successivi del GUID.The next 2 bytes of the GUID.

c
Int16

I 2 byte successivi del GUID.The next 2 bytes of the GUID.

d
Byte

Byte successivo del GUID.The next byte of the GUID.

e
Byte

Byte successivo del GUID.The next byte of the GUID.

f
Byte

Byte successivo del GUID.The next byte of the GUID.

g
Byte

Byte successivo del GUID.The next byte of the GUID.

h
Byte

Byte successivo del GUID.The next byte of the GUID.

i
Byte

Byte successivo del GUID.The next byte of the GUID.

j
Byte

Byte successivo del GUID.The next byte of the GUID.

k
Byte

Byte successivo del GUID.The next byte of the GUID.

Esempi

Nell'esempio seguente viene creato un GUID la cui rappresentazione di stringa è "0000000A-000B-000C-0001-020304050607".The following example creates a GUID whose string representation is "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}
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}

Commenti

La specifica di singoli byte in questo modo può essere utilizzata per aggirare le restrizioni per l'ordine dei byte (ordine dei byte big-endian o little-endian) su determinati tipi di computer.Specifying individual bytes in this manner can be used to circumvent byte order restrictions (big-endian or little-endian byte order) on particular types of computers.

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

Importante

Questa API non è conforme a CLS.

Inizializza una nuova istanza della struttura Guid usando gli interi senza segno e i byte specificati.Initializes a new instance of the Guid structure by using the specified unsigned integers and bytes.

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);
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)

Parametri

a
UInt32

Primi 4 byte del GUID.The first 4 bytes of the GUID.

b
UInt16

I 2 byte successivi del GUID.The next 2 bytes of the GUID.

k
Byte

Byte successivo del GUID.The next byte of the GUID.

c
UInt16

I 2 byte successivi del GUID.The next 2 bytes of the GUID.

d
Byte

Byte successivo del GUID.The next byte of the GUID.

e
Byte

Byte successivo del GUID.The next byte of the GUID.

f
Byte

Byte successivo del GUID.The next byte of the GUID.

g
Byte

Byte successivo del GUID.The next byte of the GUID.

h
Byte

Byte successivo del GUID.The next byte of the GUID.

i
Byte

Byte successivo del GUID.The next byte of the GUID.

j
Byte

Byte successivo del GUID.The next byte of the GUID.

Attributi

Esempi

GUID (0xA, 0xb, 0xc, 0, 1, 2, 3, 4, 5, 6, 7) crea un Guid che corrisponde a "0000000A-000B-000C-0001-020304050607".Guid(0xa,0xb,0xc,0,1,2,3,4,5,6,7) creates a Guid that corresponds to "0000000a-000b-000c-0001-020304050607".

Commenti

Se si specificano i byte in questo modo, vengono evitati i problemi relativi all'emissione.Specifying the bytes in this manner avoids endianness issues.

Si applica a