Guid Constructeurs

Définition

Espace de noms:: System

Assemblys:: mscorlib.dll, System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: System.Runtime.dll

Assembly:: netstandard.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Initialise une nouvelle instance de la Guid structure.

Surcharges

Nom	Description
Guid(Byte[])	Initialise une nouvelle instance de la Guid structure à l’aide du tableau spécifié d’octets.
Guid(ReadOnlySpan<Byte>)	Initialise une nouvelle instance de la Guid structure à l’aide de la valeur représentée par l’étendue en lecture seule spécifiée d’octets.
Guid(String)	Initialise une nouvelle instance de la Guid structure à 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 Guid structure à 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 Guid structure à l’aide des entiers et octets spécifiés.
Guid(UInt32, UInt16, UInt16, Byte, Byte, Byte, Byte, Byte, Byte, Byte, Byte)	Initialise une nouvelle instance de la Guid structure à l’aide des entiers et octets non signés spécifiés.

Guid(Byte[])

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

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 de 16 éléments contenant des valeurs avec lesquelles initialiser le GUID.

Exceptions

ArgumentNullException

b a la valeur null.

ArgumentException

b n’est pas de 16 octets de long.

S’applique à

Guid(ReadOnlySpan<Byte>)

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

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 être exactement de 16 octets de long.

Exceptions

ArgumentException

L’étendue doit être exactement de 16 octets de long.

S’applique à

Guid(String)

Initialise une nouvelle instance de la Guid structure à 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 :

-ou-

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

d-d-d-d-d-d

-ou-

{dddd-d-d-d-d-d}

-ou-

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

-ou-

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

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

Tous les accolades, virgules et préfixes « 0x » sont requis. Tous les espaces incorporés sont ignorés. Tous les zéros non significatifs d’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 supposés être les chiffres de bas ordre du groupe.

Exceptions

ArgumentNullException

g a la valeur null.

FormatException

Le format de g ce paramètre n’est pas valide.

OverflowException

Le format de g ce paramètre 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 :

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

S’applique à

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

Initialise une nouvelle instance de la Guid structure à 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

Les 4 premiers octets du GUID.

b: Int16

2 octets suivants du GUID.

c: Int16

2 octets suivants du GUID.

d: Byte[]

8 octets restants du GUID.

Exceptions

ArgumentNullException

d a la valeur null.

ArgumentException

d n’est pas de 8 octets de long.

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 Guid structure à l’aide des entiers et 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

Les 4 premiers octets du GUID.

b: Int16

2 octets suivants du GUID.

c: Int16

2 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 « 000000a-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 certains types d’ordinateurs.

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 Guid structure à l’aide des entiers et 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

Les 4 premiers octets du GUID.

b: UInt16

2 octets suivants du GUID.

c: UInt16

2 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: CLSCompliantAttribute

Remarques

La spécification des octets de cette façon évite les problèmes d’endianness.

S’applique à

Commentaires

Cette page a-t-elle été utile ?