Guid Konstruktoren

Definition

Initialisiert eine neue Instanz der Guid-Struktur.

Überlädt

Guid(Byte[])

Initialisiert eine neue Instanz der Guid-Struktur unter Verwendung des angegebenen Bytearrays.

Guid(ReadOnlySpan<Byte>)

Initialisiert eine neue Instanz der Guid-Struktur unter Verwendung des von der angegebenen schreibgeschützten Bytespanne dargestellten Werts.

Guid(String)

Initialisiert eine neue Instanz der Guid-Struktur unter Verwendung des von der angegebenen Zeichenfolge dargestellten Werts.

Guid(ReadOnlySpan<Byte>, Boolean)
Guid(Int32, Int16, Int16, Byte[])

Initialisiert eine neue Instanz der Guid-Struktur unter Verwendung der angegebenen Ganzzahlen und der angegebenen Bytes.

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.

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

Initialisiert eine neue Instanz der Guid-Struktur unter Verwendung der angegebenen Ganzzahlen und der angegebenen Bytes.

Guid(Byte[])

Initialisiert eine neue Instanz der Guid-Struktur unter Verwendung des angegebenen Bytearrays.

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.

Ausnahmen

b ist null.

b hat keine Länge von 16 Bytes.

Gilt für:

Guid(ReadOnlySpan<Byte>)

Initialisiert eine neue Instanz der Guid-Struktur unter Verwendung des von der angegebenen schreibgeschützten Bytespanne dargestellten Werts.

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. Die Spanne muss genau 16 Byte lang sein.

Ausnahmen

Die Spanne muss genau 16 Byte lang sein.

Gilt für:

Guid(String)

Initialisiert eine neue Instanz der Guid-Struktur unter Verwendung des von der angegebenen Zeichenfolge dargestellten Werts.

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

32 zusammenhängende Hexadezimalstellen:

zzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzz

- oder -

Gruppen von 8, 4, 4, 4 und 12 Hexadezimalziffern mit Bindestrichen zwischen den Gruppen. Die gesamte GUID kann optional in zueinander passende geschweifte oder einfache Klammern eingeschlossen werden:

zzzzzzzz-zzzz-zzzz-zzzz-zzzzzzzzzzzz

- oder -

{zzzzzzzz-zzzz-zzzz-zzzz-zzzzzzzzzzzz}

- oder -

(zzzzzzzz-zzzz-zzzz-zzzz-zzzzzzzzzzzz)

- oder -

Gruppen mit 8, 4 und 4 Hexadezimalziffern und einer Teilmenge von acht Gruppen von 2 Hexadezimalstellen, wobei jeder Gruppe "0x" oder "0X" vorangestellt und durch Kommas getrennt ist. Die gesamte GUID und die Untergruppe wird in zueinander passende Klammern eingeschlossen:

{0xzzzzzzzz, 0xzzzz, 0xzzzz,{0xzz,0xzz,0xzz,0xzz,0xzz,0xzz,0xzz,0xzz}}

Dabei sind die Klammern, die Kommas und die "0x"-Präfixe erforderlich. Eingebettete Leerzeichen werden ignoriert. Führende Nullen in einer Gruppe werden ignoriert.

Die in einer Gruppe angezeigten Hexadezimalziffern sind die maximale Anzahl aussagekräftiger Hexadezimalziffern, die in dieser Gruppe angezeigt werden können. Sie können von 1 bis zur Anzahl der hexadezimalen Ziffern angeben, die für eine Gruppe angezeigt werden. Die angegebenen Ziffern werden dabei als die zuletzt stehenden Ziffern der Gruppe ausgewertet.

Ausnahmen

g ist null.

Das Format von g ist ungültig.

Das Format von g ist ungültig.

Beispiele

Im folgenden Beispiel wird jede im Abschnitt Hinweise aufgeführte Zeichenfolge an den Guid(String) Konstruktor übergeben.

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

Hinweise

Die alphabetischen Hexadezimalziffern im g Parameter können Groß- oder Kleinbuchstaben sein. Die folgenden Zeichenfolgen stellen beispielsweise die gleiche GUID dar:

"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}}"

Gilt für:

Guid(ReadOnlySpan<Byte>, Boolean)

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)

Parameter

bigEndian
Boolean

Gilt für:

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

Initialisiert eine neue Instanz der Guid-Struktur unter Verwendung der angegebenen Ganzzahlen und der angegebenen Bytes.

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.

b
Int16

Die nächsten 2 Bytes der GUID.

c
Int16

Die nächsten 2 Bytes der GUID.

d
Byte[]

Die restlichen 8 Bytes der GUID.

Ausnahmen

d ist null.

d hat keine Länge von 8 Bytes.

Beispiele

Guid(1,2,3,new byte[]{0,1,2,3,4,5,6,7}) erstellt eine Guid , die "000000001-0002-0003-0001-020304050607" entspricht.

Gilt für:

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.

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.

b
Int16

Die nächsten 2 Bytes der GUID.

c
Int16

Die nächsten 2 Bytes der GUID.

d
Byte

Das nächste Byte der GUID.

e
Byte

Das nächste Byte der GUID.

f
Byte

Das nächste Byte der GUID.

g
Byte

Das nächste Byte der GUID.

h
Byte

Das nächste Byte der GUID.

i
Byte

Das nächste Byte der GUID.

j
Byte

Das nächste Byte der GUID.

k
Byte

Das nächste Byte der GUID.

Beispiele

Im folgenden Beispiel wird eine GUID erstellt, deren Zeichenfolgendarstellung "000000a-000b-000c-0001-020304050607" lautet.

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}

Hinweise

Die Angabe einzelner Bytes auf diese Weise kann verwendet werden, um Bytereihenfolgeeinschränkungen (Big-Endian oder Little-Endian-Bytereihenfolge) auf bestimmten Computertypen zu umgehen.

Gilt für:

Guid(UInt32, UInt16, UInt16, Byte, 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.

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)

Parameter

a
UInt32

Die ersten 4 Bytes der GUID.

b
UInt16

Die nächsten 2 Bytes der GUID.

c
UInt16

Die nächsten 2 Bytes der GUID.

d
Byte

Das nächste Byte der GUID.

e
Byte

Das nächste Byte der GUID.

f
Byte

Das nächste Byte der GUID.

g
Byte

Das nächste Byte der GUID.

h
Byte

Das nächste Byte der GUID.

i
Byte

Das nächste Byte der GUID.

j
Byte

Das nächste Byte der GUID.

k
Byte

Das nächste Byte der GUID.

Attribute

Hinweise

Wenn Sie die Bytes auf diese Weise angeben, werden Probleme mit der Endianität vermieden.

Gilt für: