Guid Konstruktoren

Definition

Initialisiert eine neue Instanz der Guid-Struktur.Initializes a new instance of the Guid structure.

Überlädt

Guid(Byte[])

Initialisiert eine neue Instanz der Guid-Struktur unter Verwendung des angegebenen Bytearrays.Initializes a new instance of the Guid structure by using the specified array of bytes.

Guid(ReadOnlySpan<Byte>)

Initialisiert eine neue Instanz der Guid-Struktur unter Verwendung des von der angegebenen schreibgeschützten Bytespanne dargestellten Werts.Initializes a new instance of the Guid structure by using the value represented by the specified read-only span of bytes.

Guid(String)

Initialisiert eine neue Instanz der Guid-Struktur unter Verwendung des von der angegebenen Zeichenfolge dargestellten Werts.Initializes a new instance of the Guid structure by using the value represented by the specified string.

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

Initialisiert eine neue Instanz der Guid-Struktur unter Verwendung der angegebenen Ganzzahlen und der angegebenen Bytes.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)

Initialisiert eine neue Instanz der Guid-Struktur unter Verwendung der angegebenen Ganzzahlen und der angegebenen Bytes.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)

Initialisiert eine neue Instanz der Guid-Struktur unter Verwendung der angegebenen Ganzzahlen und der angegebenen Bytes.Initializes a new instance of the Guid structure by using the specified unsigned integers and bytes.

Guid(Byte[])

Initialisiert eine neue Instanz der Guid-Struktur unter Verwendung des angegebenen Bytearrays.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())

Parameter

b
Byte[]

Ein aus 16 Elementen bestehendes Bytearray mit Werten, mit denen die GUID initialisiert wird.A 16-element byte array containing values with which to initialize the GUID.

Ausnahmen

b ist null.b is null.

b hat keine Länge von 16 Bytes.b is not 16 bytes long.

Guid(ReadOnlySpan<Byte>)

Initialisiert eine neue Instanz der Guid-Struktur unter Verwendung des von der angegebenen schreibgeschützten Bytespanne dargestellten Werts.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))

Parameter

b
ReadOnlySpan<Byte>

Eine schreibgeschützte Spanne, die die Bytes enthält, die die GUID darstellen.A read-only span containing the bytes representing the GUID. Die Spanne muss genau 16 Byte lang sein.The span must be exactly 16 bytes long.

Ausnahmen

Die Spanne muss genau 16 Byte lang sein.The span must be exactly 16 bytes long.

Guid(String)

Initialisiert eine neue Instanz der Guid-Struktur unter Verwendung des von der angegebenen Zeichenfolge dargestellten Werts.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)

Parameter

g
String

Eine Zeichenfolge, die eine GUID in einem der folgenden Formate enthält ("z" stellt eine Hexadezimalziffer dar, bei der die Groß- und Kleinschreibung nicht berücksichtigt wird):A string that contains a GUID in one of the following formats ("d" represents a hexadecimal digit whose case is ignored):

32 aufeinander folgende Ziffern:32 contiguous digits:

zzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzdddddddddddddddddddddddddddddddd

- oder --or-

Gruppen von 8, 4, 4, 4 und 12 Ziffern, die durch Bindestriche verbunden sind.Groups of 8, 4, 4, 4, and 12 digits with hyphens between the groups. Die gesamte GUID kann optional in zueinander passende geschweifte oder einfache Klammern eingeschlossen werden:The entire GUID can optionally be enclosed in matching braces or parentheses:

zzzzzzzz-zzzz-zzzz-zzzz-zzzzzzzzzzzzdddddddd-dddd-dddd-dddd-dddddddddddd

- oder --or-

{zzzzzzzz-zzzz-zzzz-zzzz-zzzzzzzzzzzz}{dddddddd-dddd-dddd-dddd-dddddddddddd}

- oder --or-

(zzzzzzzz-zzzz-zzzz-zzzz-zzzzzzzzzzzz)(dddddddd-dddd-dddd-dddd-dddddddddddd)

- oder --or-

Gruppen von 8, 4 und 4 Ziffern und eine Untergruppe von acht Gruppen zu je 2 Ziffern mit dem Präfix "0x" bzw. "0X", die durch Kommas getrennt sind.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. Die gesamte GUID und die Untergruppe wird in zueinander passende Klammern eingeschlossen:The entire GUID, as well as the subset, is enclosed in matching braces:

{0xzzzzzzzz, 0xzzzz, 0xzzzz,{0xzz,0xzz,0xzz,0xzz,0xzz,0xzz,0xzz,0xzz}}{0xdddddddd, 0xdddd, 0xdddd,{0xdd,0xdd,0xdd,0xdd,0xdd,0xdd,0xdd,0xdd}}

Dabei sind die Klammern, die Kommas und die "0x"-Präfixe erforderlich.All braces, commas, and "0x" prefixes are required. Eingebettete Leerzeichen werden ignoriert.All embedded spaces are ignored. Führende Nullen in einer Gruppe werden ignoriert.All leading zeros in a group are ignored.

Die in einer Gruppe angezeigten Ziffern stellen die maximale Anzahl der in einer Gruppe zulässigen auswertbaren Ziffern dar.The digits shown in a group are the maximum number of meaningful digits that can appear in that group. Sie können dabei eine Anzahl von Ziffern zwischen 1 und der für eine Gruppe angezeigten Anzahl angeben.You can specify from 1 to the number of digits shown for a group. Die angegebenen Ziffern werden dabei als die zuletzt stehenden Ziffern der Gruppe ausgewertet.The specified digits are assumed to be the low-order digits of the group.

Ausnahmen

g ist null.g is null.

Das Format von g ist ungültig.The format of g is invalid.

Das Format von g ist ungültig.The format of g is invalid.

Beispiele

Im folgenden Beispiel wird jede im Abschnitt "Hinweise" aufgeführte Zeichenfolge an den Guid(String)-Konstruktor übergeben.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

Hinweise

Bei den alphabetischen hexadezimalen Ziffern des Parameters "g" kann es sich um einen groß-oder Kleinbuchstaben handeln.The alphabetic hexadecimal digits in the g parameter can be uppercase or lowercase. Die folgenden Zeichen folgen stellen z. b. dieselbe GUID dar: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[])

Initialisiert eine neue Instanz der Guid-Struktur unter Verwendung der angegebenen Ganzzahlen und der angegebenen Bytes.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())

Parameter

a
Int32

Die ersten 4 Bytes der GUID.The first 4 bytes of the GUID.

b
Int16

Die nächsten 2 Bytes der GUID.The next 2 bytes of the GUID.

c
Int16

Die nächsten 2 Bytes der GUID.The next 2 bytes of the GUID.

d
Byte[]

Die restlichen 8 Bytes der GUID.The remaining 8 bytes of the GUID.

Ausnahmen

d ist null.d is null.

d hat keine Länge von 8 Bytes.d is not 8 bytes long.

Beispiele

Guid(1,2,3,new byte[]{0,1,2,3,4,5,6,7}) erstellt einen Guid, der "00000001-0002-0003-0001-020304050607" entspricht.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)

Initialisiert eine neue Instanz der Guid-Struktur unter Verwendung der angegebenen Ganzzahlen und der angegebenen Bytes.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)

Parameter

a
Int32

Die ersten 4 Bytes der GUID.The first 4 bytes of the GUID.

b
Int16

Die nächsten 2 Bytes der GUID.The next 2 bytes of the GUID.

c
Int16

Die nächsten 2 Bytes der GUID.The next 2 bytes of the GUID.

d
Byte

Das nächste Byte der GUID.The next byte of the GUID.

e
Byte

Das nächste Byte der GUID.The next byte of the GUID.

f
Byte

Das nächste Byte der GUID.The next byte of the GUID.

g
Byte

Das nächste Byte der GUID.The next byte of the GUID.

h
Byte

Das nächste Byte der GUID.The next byte of the GUID.

i
Byte

Das nächste Byte der GUID.The next byte of the GUID.

j
Byte

Das nächste Byte der GUID.The next byte of the GUID.

k
Byte

Das nächste Byte der GUID.The next byte of the GUID.

Beispiele

Im folgenden Beispiel wird eine GUID erstellt, deren Zeichen folgen Darstellung "0000000a-000b-000c-0001-020304050607" ist.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}

Hinweise

Die Angabe einzelner Bytes auf diese Weise kann verwendet werden, um die Byte Reihenfolge-Einschränkungen (Big-Endian oder Little-Endian-Byte Reihenfolge) für bestimmte Arten von Computern zu umgehen.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)

Wichtig

Diese API ist nicht CLS-kompatibel.

Initialisiert eine neue Instanz der Guid-Struktur unter Verwendung der angegebenen Ganzzahlen und der angegebenen Bytes.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)

Parameter

a
UInt32

Die ersten 4 Bytes der GUID.The first 4 bytes of the GUID.

b
UInt16

Die nächsten 2 Bytes der GUID.The next 2 bytes of the GUID.

k
Byte

Das nächste Byte der GUID.The next byte of the GUID.

c
UInt16

Die nächsten 2 Bytes der GUID.The next 2 bytes of the GUID.

d
Byte

Das nächste Byte der GUID.The next byte of the GUID.

e
Byte

Das nächste Byte der GUID.The next byte of the GUID.

f
Byte

Das nächste Byte der GUID.The next byte of the GUID.

g
Byte

Das nächste Byte der GUID.The next byte of the GUID.

h
Byte

Das nächste Byte der GUID.The next byte of the GUID.

i
Byte

Das nächste Byte der GUID.The next byte of the GUID.

j
Byte

Das nächste Byte der GUID.The next byte of the GUID.

Attribute

Beispiele

GUID (0xa, 0xb, 0xc, 0, 1, 2, 3, 4, 5, 6, 7) erstellt eine Guid, die "0000000a-000b-000c-0001-020304050607" entspricht.Guid(0xa,0xb,0xc,0,1,2,3,4,5,6,7) creates a Guid that corresponds to "0000000a-000b-000c-0001-020304050607".

Hinweise

Wenn Sie die Bytes auf diese Weise angeben, werden Probleme beim einschließen vermieden.Specifying the bytes in this manner avoids endianness issues.

Gilt für: