Partage via


Guid Constructeurs

Définition

Initialise une nouvelle instance de la structure Guid.

Surcharges

Guid(Byte[])

Initialise une nouvelle instance de la structure Guid à l'aide du tableau d'octets spécifié.

Guid(ReadOnlySpan<Byte>)

Initialise une nouvelle instance de la structure Guid à l'aide de la valeur représentée par la plage d’octets en lecture seule spécifiée.

Guid(String)

Initialise une nouvelle instance de la structure Guid à l'aide de la valeur représentée par la chaîne spécifiée.

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

Initialise une nouvelle instance de la structure Guid à l'aide des entiers et du tableau d'octets spécifiés.

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

Initialise une nouvelle instance de la structure Guid à l'aide des entiers et des octets spécifiés.

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

Initialise une nouvelle instance de la structure Guid à l'aide des entiers et des octets non signés spécifiés.

Guid(Byte[])

Initialise une nouvelle instance de la structure Guid à l'aide du tableau d'octets spécifié.

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

Paramètres

b
Byte[]

Tableau d'octets à 16 éléments contenant les valeurs avec lesquelles initialiser le GUID.

Exceptions

b a la valeur null.

b ne fait pas 16 octets de long.

S’applique à

Guid(ReadOnlySpan<Byte>)

Initialise une nouvelle instance de la structure Guid à l'aide de la valeur représentée par la plage d’octets en lecture seule spécifiée.

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

Paramètres

b
ReadOnlySpan<Byte>

Étendue en lecture seule contenant les octets représentant le GUID. L’étendue doit avoir une longueur de 16 octets exactement.

Exceptions

L’étendue doit avoir une longueur de 16 octets exactement.

S’applique à

Guid(String)

Initialise une nouvelle instance de la structure Guid à l'aide de la valeur représentée par la chaîne spécifiée.

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

Paramètres

g
String

Chaîne qui contient un GUID dans l'un des formats suivants (« d » représente un chiffre hexadécimal dont la casse est ignorée) :

32 chiffres hexadécimaux contigus :

dddddddddddddddddddddddddddddddd

  • ou -

Groupes de 8, 4, 4, 4 et 12 chiffres hexadécimaux avec des traits d’union entre les groupes. Le GUID entier peut éventuellement être placé entre accolades ou parenthèses :

dddddddd-dddd-dddd-dddd-dddddddddddd

  • ou -

{dddddddd-dddd-dddd-dddd-dddddddddddd}

  • ou -

(dddddddd-dddd-dddd-dddd-dddddddddddd)

  • ou -

Groupes de 8, 4 et 4 chiffres hexadécimaux, et un sous-ensemble de huit groupes de 2 chiffres hexadécimaux, avec chaque groupe préfixé par « 0x » ou « 0X », et séparé par des virgules. Le GUID entier, ainsi que le sous-ensemble, est placé entre accolades :

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

Tous les préfixes « 0x », accolades et virgules sont requis. Tous les espaces incorporés sont ignorés. Tous les zéros non significatifs dans un groupe sont ignorés.

Les chiffres hexadécimaux affichés dans un groupe sont le nombre maximal de chiffres hexadécimaux significatifs qui peuvent apparaître dans ce groupe. Vous pouvez spécifier entre 1 et le nombre de chiffres hexadécimaux affichés pour un groupe. Les chiffres spécifiés sont considérés comme les chiffres d'ordre bas du groupe.

Exceptions

g a la valeur null.

Le format de g n’est pas valide.

Le format de g n’est pas valide.

Exemples

L’exemple suivant transmet chaque chaîne répertoriée dans la section Notes au Guid(String) constructeur.

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

Remarques

Les chiffres hexadécimaux alphabétiques du g paramètre peuvent être en majuscules ou en minuscules. Par exemple, les chaînes suivantes représentent le même GUID :

« ca761232ed4211cebacd00aa00057b223 »

« 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}} »

S’applique à

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

Initialise une nouvelle instance de la structure Guid à l'aide des entiers et du tableau d'octets spécifiés.

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

Paramètres

a
Int32

Quatre premiers octets du GUID.

b
Int16

Deux octets suivants du GUID.

c
Int16

Deux octets suivants du GUID.

d
Byte[]

Huit octets restants du GUID.

Exceptions

d a la valeur null.

d n’a pas une longueur de 8 octets.

Exemples

Guid(1,2,3,new byte[]{0,1,2,3,4,5,6,7}) crée un Guid qui correspond à « 00000001-0002-0003-0001-020304050607 ».

S’applique à

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

Initialise une nouvelle instance de la structure Guid à l'aide des entiers et des octets spécifiés.

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)

Paramètres

a
Int32

Quatre premiers octets du GUID.

b
Int16

Deux octets suivants du GUID.

c
Int16

Deux octets suivants du GUID.

d
Byte

Octet suivant du GUID.

e
Byte

Octet suivant du GUID.

f
Byte

Octet suivant du GUID.

g
Byte

Octet suivant du GUID.

h
Byte

Octet suivant du GUID.

i
Byte

Octet suivant du GUID.

j
Byte

Octet suivant du GUID.

k
Byte

Octet suivant du GUID.

Exemples

L’exemple suivant crée un GUID dont la représentation sous forme de chaîne est « 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}

Remarques

La spécification d’octets individuels de cette manière peut être utilisée pour contourner les restrictions d’ordre d’octets (ordre d’octet big-endian ou little-endian) sur des types d’ordinateurs particuliers.

S’applique à

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

Important

Cette API n’est pas conforme CLS.

Initialise une nouvelle instance de la structure Guid à l'aide des entiers et des octets non signés spécifiés.

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)

Paramètres

a
UInt32

Quatre premiers octets du GUID.

b
UInt16

Deux octets suivants du GUID.

c
UInt16

Deux octets suivants du GUID.

d
Byte

Octet suivant du GUID.

e
Byte

Octet suivant du GUID.

f
Byte

Octet suivant du GUID.

g
Byte

Octet suivant du GUID.

h
Byte

Octet suivant du GUID.

i
Byte

Octet suivant du GUID.

j
Byte

Octet suivant du GUID.

k
Byte

Octet suivant du GUID.

Attributs

Remarques

La spécification des octets de cette manière évite les problèmes d’endianness.

S’applique à