Guid Konstruktoren

Definition

Namespace:
System
Assemblys:
mscorlib.dll, System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
System.Runtime.dll
Assembly:
netstandard.dll

Initialisiert eine neue Instanz der Guid Struktur.

Überlädt

Name Beschreibung
Guid(Byte[])

Initialisiert eine neue Instanz der Guid Struktur mithilfe des angegebenen Bytearrays.
Guid(ReadOnlySpan<Byte>)

Initialisiert eine neue Instanz der Guid Struktur mithilfe des Werts, der durch den angegebenen schreibgeschützten Bytebereich dargestellt wird.
Guid(String)

Initialisiert eine neue Instanz der Guid Struktur mithilfe des durch die angegebene Zeichenfolge dargestellten Werts.
Guid(Int32, Int16, Int16, Byte[])

Initialisiert eine neue Instanz der Struktur mithilfe der Guid angegebenen Ganzzahlen und bytearrays.
Guid(Int32, Int16, Int16, Byte, Byte, Byte, Byte, Byte, Byte, Byte, Byte)

Initialisiert eine neue Instanz der Guid Struktur mithilfe der angegebenen Ganzzahlen und Bytes.
Guid(UInt32, UInt16, UInt16, Byte, Byte, Byte, Byte, Byte, Byte, Byte, Byte)

Initialisiert eine neue Instanz der Guid Struktur mithilfe der angegebenen nicht signierten ganzzahligen Zahlen und Bytes.

Guid(Byte[])

Initialisiert eine neue Instanz der Guid Struktur mithilfe 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 Bytearray mit 16 Elementen, das Werte enthält, mit denen die GUID initialisiert werden soll.

Ausnahmen

ArgumentNullException

b ist null.

ArgumentException

b ist nicht 16 Bytes lang.

Gilt für:

Guid(ReadOnlySpan<Byte>)

Initialisiert eine neue Instanz der Guid Struktur mithilfe des Werts, der durch den angegebenen schreibgeschützten Bytebereich dargestellt wird.

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 mit den Bytes, die die GUID darstellen. Die Spanne muss genau 16 Byte lang sein.

Ausnahmen

ArgumentException

Die Spanne muss genau 16 Byte lang sein.

Gilt für:

Guid(String)

Initialisiert eine neue Instanz der Guid Struktur mithilfe des durch die angegebene 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 ("d" stellt eine hexadezimale Ziffer dar, deren Groß-/Kleinschreibung ignoriert wird):

32 zusammenhängende hexadezimale Ziffern:

dd

-oder-

Gruppen von 8, 4, 4, 4 und 12 Hexadezimalstellen mit Bindestrichen zwischen den Gruppen. Die gesamte GUID kann optional in übereinstimmende geschweifte Klammern oder Klammern eingeschlossen werden:

dd-dddd-d-d-d

-oder-

{dd-dddd-d-d-d}

-oder-

(dd-dddd-d-d-d

-oder-

Gruppen von 8, 4 und 4 hexadezimalen Ziffern und eine Teilmenge von acht Gruppen von 2 Hexadezimalziffern, wobei jede Gruppe mit dem Präfix "0x" oder "0X" und durch Kommas getrennt ist. Die gesamte GUID sowie die Teilmenge werden in übereinstimmende geschweifte Klammern eingeschlossen:

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

Alle Klammern, Kommas und "0x"-Präfixe sind erforderlich. Alle eingebetteten Leerzeichen werden ignoriert. Alle führenden Nullen in einer Gruppe werden ignoriert.

Die in einer Gruppe angezeigten hexadezimalen Ziffern sind die maximale Anzahl aussagekräftiger Hexadezimalziffern, die in dieser Gruppe angezeigt werden können. Sie können zwischen 1 und der Anzahl der hexadezimalen Ziffern angeben, die für eine Gruppe angezeigt werden. Bei den angegebenen Ziffern wird davon ausgegangen, dass es sich um die Ziffern mit niedriger Reihenfolge der Gruppe handelt.

Ausnahmen

ArgumentNullException

g ist null.

FormatException

Das Format von g ist ungültig.

OverflowException

Das Format von g ist ungültig.

Beispiele

Im folgenden Beispiel werden die im Abschnitt "Hinweise" aufgeführten Zeichenfolgen 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 hexadezimalen Ziffern im g Parameter können Groß- oder Kleinbuchstaben sein. Die folgenden Zeichenfolgen stellen beispielsweise dieselbe 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(Int32, Int16, Int16, Byte[])

Initialisiert eine neue Instanz der Struktur mithilfe der Guid angegebenen Ganzzahlen und bytearrays.

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 Byte der GUID.

b
Int16

Die nächsten 2 Byte der GUID.

c
Int16

Die nächsten 2 Byte der GUID.

d
Byte[]

Die verbleibenden 8 Bytes der GUID.

Ausnahmen

ArgumentNullException

d ist null.

ArgumentException

d ist nicht 8 Bytes lang.

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.

Gilt für:

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

Initialisiert eine neue Instanz der Guid Struktur mithilfe der angegebenen Ganzzahlen und 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 Byte der GUID.

b
Int16

Die nächsten 2 Byte der GUID.

c
Int16

Die nächsten 2 Byte 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 "00000a-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 Byte-Reihenfolge) 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 mithilfe der angegebenen nicht signierten ganzzahligen Zahlen und 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 Byte der GUID.

b
UInt16

Die nächsten 2 Byte der GUID.

c
UInt16

Die nächsten 2 Byte 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
CLSCompliantAttribute

Hinweise

Die Angabe der Bytes auf diese Weise vermeidet Endianness-Probleme.

Gilt für: