Guid Guid Guid Guid Constructors

Definition

Überlädt

Guid(Byte[]) Guid(Byte[]) Guid(Byte[]) 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>) Guid(ReadOnlySpan<Byte>) Guid(ReadOnlySpan<Byte>) Guid(ReadOnlySpan<Byte>)
Guid(String) Guid(String) Guid(String) 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[]) Guid(Int32, Int16, Int16, Byte[]) Guid(Int32, Int16, Int16, Byte[]) 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) Guid(Int32, Int16, Int16, Byte, Byte, Byte, Byte, Byte, Byte, Byte, Byte) Guid(Int32, Int16, Int16, Byte, Byte, Byte, Byte, Byte, Byte, Byte, Byte) 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) Guid(UInt32, UInt16, Byte, UInt16, Byte, Byte, Byte, Byte, Byte, Byte, Byte) Guid(UInt32, UInt16, Byte, UInt16, Byte, Byte, Byte, Byte, Byte, Byte, Byte) 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[]) Guid(Byte[]) Guid(Byte[]) 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 hat keine Länge von 16 Bytes.b is not 16 bytes long.

Guid(ReadOnlySpan<Byte>) Guid(ReadOnlySpan<Byte>) Guid(ReadOnlySpan<Byte>) Guid(ReadOnlySpan<Byte>)

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

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

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

Das folgende Beispiel übergibt die Zeichenfolge aufgeführt, die im Abschnitt "Hinweise", um die Guid(String) Konstruktor.The following example passes each string listed in the Remarks section to the Guid(String) constructor.

using System;

public class Example
{
   public static void Main()
   {
      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) {
         Guid guid = new Guid(guidString);
         Console.WriteLine("Original string: {0}", guidString);
         Console.WriteLine("Guid:            {0}", 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

Die alphabetischen Hexadezimalzeichen in die g Parameter wird die Groß- und Kleinbuchstaben.The alphabetic hexadecimal digits in the g parameter can be uppercase or lowercase. Beispielsweise stellen die folgenden Zeichenfolgen 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[]) Guid(Int32, Int16, Int16, Byte[]) Guid(Int32, Int16, Int16, Byte[]) 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 Int32 Int32 Int32

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

b
Int16 Int16 Int16 Int16

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

c
Int16 Int16 Int16 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 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 eine Guid , die "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) Guid(Int32, Int16, Int16, Byte, Byte, Byte, Byte, Byte, Byte, Byte, Byte) Guid(Int32, Int16, Int16, Byte, Byte, Byte, Byte, Byte, Byte, Byte, Byte) 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 Int32 Int32 Int32

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

b
Int16 Int16 Int16 Int16

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

c
Int16 Int16 Int16 Int16

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

d
Byte Byte Byte Byte

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

e
Byte Byte Byte Byte

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

f
Byte Byte Byte Byte

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

g
Byte Byte Byte Byte

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

h
Byte Byte Byte Byte

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

i
Byte Byte Byte Byte

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

j
Byte Byte Byte Byte

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

k
Byte Byte Byte Byte

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

Beispiele

Im folgende Beispiel wird eine GUID, dessen Zeichenfolgendarstellung "0000000a-000b-000c-0001-020304050607" wird, erstellt.The following example creates a GUID whose string representation is "0000000a-000b-000c-0001-020304050607".

using System;

public class Example
{
   public static void Main()
   {
      Guid g = new Guid(0xA, 0xB, 0xC, 
                        new Byte[] { 0, 1, 2, 3, 4, 5, 6, 7 } );
      Console.WriteLine("{0:B}", g);
   }
}
// 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

Angeben der einzelnen Bytes auf diese Weise kann verwendet werden, um Byte-Order-Einschränkungen (big-Endian oder little-Endian-Bytereihenfolge) 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) Guid(UInt32, UInt16, Byte, UInt16, Byte, Byte, Byte, Byte, Byte, Byte, Byte) Guid(UInt32, UInt16, Byte, UInt16, Byte, Byte, Byte, Byte, Byte, Byte, Byte) 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 UInt32 UInt32 UInt32

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

b
UInt16 UInt16 UInt16 UInt16

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

k
Byte Byte Byte Byte

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

c
UInt16 UInt16 UInt16 UInt16

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

d
Byte Byte Byte Byte

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

e
Byte Byte Byte Byte

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

f
Byte Byte Byte Byte

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

g
Byte Byte Byte Byte

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

h
Byte Byte Byte Byte

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

i
Byte Byte Byte Byte

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

j
Byte Byte Byte Byte

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

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

Durch Angeben der Bytes auf diese Weise werden die Bytereihenfolge-Probleme vermeidet.Specifying the bytes in this manner avoids endianness issues.

Gilt für: