Guid Constructors

Definitie

Naamruimte:: System

Assembly's:: mscorlib.dll, System.Runtime.dll

Assembly's:: netstandard.dll, System.Runtime.dll

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Initialiseert een nieuw exemplaar van de Guid structuur.

Overloads

Name	Description
Guid(Byte[])	Initialiseert een nieuw exemplaar van de Guid structuur met behulp van de opgegeven matrix van bytes.
Guid(ReadOnlySpan<Byte>)	Initialiseert een nieuw exemplaar van de Guid structuur met behulp van de waarde die wordt vertegenwoordigd door de opgegeven alleen-lezen periode van bytes.
Guid(String)	Initialiseert een nieuw exemplaar van de Guid structuur met behulp van de waarde die wordt vertegenwoordigd door de opgegeven tekenreeks.
Guid(ReadOnlySpan<Byte>, Boolean)
Guid(Int32, Int16, Int16, Byte[])	Initialiseert een nieuw exemplaar van de Guid structuur met behulp van de opgegeven gehele getallen en bytematrix.
Guid(Int32, Int16, Int16, Byte, Byte, Byte, Byte, Byte, Byte, Byte, Byte)	Initialiseert een nieuw exemplaar van de Guid structuur met behulp van de opgegeven gehele getallen en bytes.
Guid(UInt32, UInt16, UInt16, Byte, Byte, Byte, Byte, Byte, Byte, Byte, Byte)	Initialiseert een nieuw exemplaar van de Guid structuur met behulp van de opgegeven niet-ondertekende gehele getallen en bytes.

Guid(Byte[])

Bron:: Guid.cs

Bron:: Guid.cs

Bron:: Guid.cs

Bron:: Guid.cs

Bron:: Guid.cs

Initialiseert een nieuw exemplaar van de Guid structuur met behulp van de opgegeven matrix van bytes.

public:
 Guid(cli::array <System::Byte> ^ b);

public Guid(byte[] b);

new Guid : byte[] -> Guid

Public Sub New (b As Byte())

Parameters

b: Byte[]

Een bytematrix met 16 elementen met waarden waarmee de GUID moet worden geïnitialiseerd.

Uitzonderingen

ArgumentNullException

b is null.

ArgumentException

b is niet 16 bytes lang.

Van toepassing op

Guid(ReadOnlySpan<Byte>)

Bron:: Guid.cs

Bron:: Guid.cs

Bron:: Guid.cs

Bron:: Guid.cs

Bron:: Guid.cs

Initialiseert een nieuw exemplaar van de Guid structuur met behulp van de waarde die wordt vertegenwoordigd door de opgegeven alleen-lezen periode van 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))

Parameters

b: ReadOnlySpan<Byte>

Een alleen-lezen periode met de bytes die de GUID vertegenwoordigen. De periode moet exact 16 bytes lang zijn.

Uitzonderingen

ArgumentException

De periode moet exact 16 bytes lang zijn.

Van toepassing op

Guid(String)

Bron:: Guid.cs

Bron:: Guid.cs

Bron:: Guid.cs

Bron:: Guid.cs

Bron:: Guid.cs

Initialiseert een nieuw exemplaar van de Guid structuur met behulp van de waarde die wordt vertegenwoordigd door de opgegeven tekenreeks.

public:
 Guid(System::String ^ g);

public Guid(string g);

new Guid : string -> Guid

Public Sub New (g As String)

Parameters

g: String

Een tekenreeks met een GUID in een van de volgende notaties ('d' vertegenwoordigt een hexadecimaal cijfer waarvan de hoofdletter wordt genegeerd):

32 aaneengesloten hexadecimale cijfers:

ddd

– of –

Groepen van 8, 4, 4, 4 en 12 hexadecimale cijfers met afbreekstreepjes tussen de groepen. De volledige GUID kan eventueel worden ingesloten in overeenkomende accolades of haakjes:

ddd-dddd-dddd-dddd-dd

– of –

{dddd-dddd-dddd-dddd-dd}

– of –

(dddd-ddddd-dddd-dddd-dd)

– of –

Groepen van 8, 4 en 4 hexadecimale cijfers, en een subset van acht groepen van 2 hexadecimale cijfers, waarbij elke groep wordt voorafgegaan door '0x' of '0X', gescheiden door komma's. De volledige GUID, evenals de subset, bevindt zich tussen overeenkomende accolades:

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

Alle accolades, komma's en 0x-voorvoegsels zijn vereist. Alle ingesloten ruimten worden genegeerd. Alle voorloopnullen in een groep worden genegeerd.

De hexadecimale cijfers die in een groep worden weergegeven, zijn het maximum aantal zinvolle hexadecimale cijfers die in die groep kunnen worden weergegeven. U kunt opgeven van 1 tot het aantal hexadecimale cijfers dat voor een groep wordt weergegeven. De opgegeven cijfers worden verondersteld de cijfers met lage volgorde van de groep te zijn.

Uitzonderingen

ArgumentNullException

g is null.

FormatException

De indeling g is ongeldig.

OverflowException

De indeling g is ongeldig.

Voorbeelden

In het volgende voorbeeld wordt elke tekenreeks in de sectie Opmerkingen doorgegeven aan de 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

Opmerkingen

De alfabetische hexadecimale cijfers in de g parameter kunnen hoofdletters of kleine letters zijn. De volgende tekenreeksen vertegenwoordigen bijvoorbeeld dezelfde 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}"

Van toepassing op

Guid(ReadOnlySpan<Byte>, Boolean)

Bron:: Guid.cs

Bron:: Guid.cs

Bron:: Guid.cs

Bron:: 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)

Parameters

b: ReadOnlySpan<Byte>

bigEndian: Boolean

Van toepassing op

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

Bron:: Guid.cs

Bron:: Guid.cs

Bron:: Guid.cs

Bron:: Guid.cs

Bron:: Guid.cs

Initialiseert een nieuw exemplaar van de Guid structuur met behulp van de opgegeven gehele getallen en bytematrix.

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

Parameters

a: Int32

De eerste 4 bytes van de GUID.

b: Int16

De volgende 2 bytes van de GUID.

c: Int16

De volgende 2 bytes van de GUID.

d: Byte[]

De resterende 8 bytes van de GUID.

Uitzonderingen

ArgumentNullException

d is null.

ArgumentException

d is niet 8 bytes lang.

Voorbeelden

Guid(1,2,3,new byte[]{0,1,2,3,4,5,6,7}) maakt een Guid bestand dat overeenkomt met '00000001-0002-0003-0001-020304050607'.

Van toepassing op

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

Bron:: Guid.cs

Bron:: Guid.cs

Bron:: Guid.cs

Bron:: Guid.cs

Bron:: Guid.cs

Initialiseert een nieuw exemplaar van de Guid structuur met behulp van de opgegeven gehele getallen en 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)

Parameters

a: Int32

De eerste 4 bytes van de GUID.

b: Int16

De volgende 2 bytes van de GUID.

c: Int16

De volgende 2 bytes van de GUID.

d: Byte

De volgende byte van de GUID.

e: Byte

De volgende byte van de GUID.

f: Byte

De volgende byte van de GUID.

g: Byte

De volgende byte van de GUID.

h: Byte

De volgende byte van de GUID.

i: Byte

De volgende byte van de GUID.

j: Byte

De volgende byte van de GUID.

k: Byte

De volgende byte van de GUID.

Voorbeelden

In het volgende voorbeeld wordt een GUID gemaakt waarvan de tekenreeksweergave 000000a-000b-000c-0001-020304050607 is.

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}

Opmerkingen

Het opgeven van afzonderlijke bytes op deze manier kan worden gebruikt om bytevolgordebeperkingen (big-endian of little-endian bytevolgorde) op bepaalde typen computers te omzeilen.

Van toepassing op

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

Bron:: Guid.cs

Bron:: Guid.cs

Bron:: Guid.cs

Bron:: Guid.cs

Bron:: Guid.cs

Belangrijk

Deze API is niet CLS-conform.

Initialiseert een nieuw exemplaar van de Guid structuur met behulp van de opgegeven niet-ondertekende gehele getallen en 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);

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

Parameters

a: UInt32

De eerste 4 bytes van de GUID.

b: UInt16

De volgende 2 bytes van de GUID.

c: UInt16

De volgende 2 bytes van de GUID.

d: Byte

De volgende byte van de GUID.

e: Byte

De volgende byte van de GUID.

f: Byte

De volgende byte van de GUID.

g: Byte

De volgende byte van de GUID.

h: Byte

De volgende byte van de GUID.

i: Byte

De volgende byte van de GUID.

j: Byte

De volgende byte van de GUID.

k: Byte

De volgende byte van de GUID.

Kenmerken: CLSCompliantAttribute

Opmerkingen

Als u op deze manier de bytes opgeeft, voorkomt u problemen met endianness.

Van toepassing op

Feedback

Is deze pagina nuttig?