Guid Konstruktory

Odwołanie

Definicja

Przestrzeń nazw:: System

Zestaw:: System.Runtime.dll

Zestaw:: mscorlib.dll

Zestaw:: netstandard.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Inicjuje Guid nowe wystąpienie struktury.

Przeciążenia

Guid(Byte[])	Inicjuje Guid nowe wystąpienie struktury przy użyciu określonej tablicy bajtów.
Guid(ReadOnlySpan<Byte>)	Inicjuje nowe wystąpienie Guid struktury przy użyciu wartości reprezentowanej przez określony zakres bajtów tylko do odczytu.
Guid(String)	Inicjuje nowe wystąpienie Guid struktury przy użyciu wartości reprezentowanej przez określony ciąg.
Guid(ReadOnlySpan<Byte>, Boolean)
Guid(Int32, Int16, Int16, Byte[])	Inicjuje nowe wystąpienie Guid struktury przy użyciu określonych liczb całkowitych i tablicy bajtów.
Guid(Int32, Int16, Int16, Byte, Byte, Byte, Byte, Byte, Byte, Byte, Byte)	Inicjuje Guid nowe wystąpienie struktury przy użyciu określonych liczb całkowitych i bajtów.
Guid(UInt32, UInt16, UInt16, Byte, Byte, Byte, Byte, Byte, Byte, Byte, Byte)	Inicjuje nowe wystąpienie Guid struktury przy użyciu określonych niepodpisanych liczb całkowitych i bajtów.

Guid(Byte[])

Źródło:: Guid.cs

Źródło:: Guid.cs

Źródło:: Guid.cs

Inicjuje Guid nowe wystąpienie struktury przy użyciu określonej tablicy bajtów.

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

public Guid (byte[] b);

new Guid : byte[] -> Guid

Public Sub New (b As Byte())

Parametry

b: Byte[]

16-elementowa tablica bajtów zawierająca wartości, za pomocą których należy zainicjować identyfikator GUID.

Wyjątki

ArgumentNullException

b to null.

ArgumentException

b nie ma 16 bajtów długości.

Dotyczy

Guid(ReadOnlySpan<Byte>)

Źródło:: Guid.cs

Źródło:: Guid.cs

Źródło:: Guid.cs

Inicjuje nowe wystąpienie Guid struktury przy użyciu wartości reprezentowanej przez określony zakres bajtów tylko do odczytu.

public:
 Guid(ReadOnlySpan<System::Byte> b);

public Guid (ReadOnlySpan<byte> b);

new Guid : ReadOnlySpan<byte> -> Guid

Public Sub New (b As ReadOnlySpan(Of Byte))

Parametry

b: ReadOnlySpan<Byte>

Zakres tylko do odczytu zawierający bajty reprezentujące identyfikator GUID. Zakres musi mieć długość dokładnie 16 bajtów.

Wyjątki

ArgumentException

Zakres musi mieć długość dokładnie 16 bajtów.

Dotyczy

Guid(String)

Źródło:: Guid.cs

Źródło:: Guid.cs

Źródło:: Guid.cs

Inicjuje nowe wystąpienie Guid struktury przy użyciu wartości reprezentowanej przez określony ciąg.

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

public Guid (string g);

new Guid : string -> Guid

Public Sub New (g As String)

Parametry

g: String

Ciąg zawierający identyfikator GUID w jednym z następujących formatów ("d" reprezentuje cyfrę szesnastkową, której wielkość liter jest ignorowana):

32 ciągłe cyfry szesnastkowe:

ddd

-lub-

Grupy 8, 4, 4, 4 i 12 cyfr szesnastkowe z łącznikami między grupami. Cały identyfikator GUID można opcjonalnie ujęć w pasujących nawiasach klamrowych lub nawiasach:

ddd-dd-d-d-d

-lub-

{ddd-d-d-d-d}

-lub-

(dd-d-d-d-d)

-lub-

Grupy 8, 4 i 4 cyfr szesnastkowe oraz podzbiór ośmiu grup szesnastkowe cyfry, z każdą grupą poprzedzoną znakiem "0x" lub "0X" i rozdzielonymi przecinkami. Cały identyfikator GUID, a także podzbiór, jest ujęty w pasujący nawiasy klamrowe:

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

Wszystkie nawiasy klamrowe, przecinki i prefiksy "0x" są wymagane. Wszystkie osadzone spacje są ignorowane. Wszystkie zera wiodące w grupie są ignorowane.

Cyfry szesnastkowe wyświetlane w grupie to maksymalna liczba znaczących cyfr szesnastkowe, które mogą pojawić się w tej grupie. Można określić od 1 do liczby cyfr szesnastowych wyświetlanych dla grupy. Przyjmuje się, że określone cyfry są cyframi o niskiej kolejności w grupie.

Wyjątki

ArgumentNullException

g to null.

FormatException

Format elementu g jest nieprawidłowy.

OverflowException

Format elementu g jest nieprawidłowy.

Przykłady

Poniższy przykład przekazuje każdy ciąg wymieniony w sekcji Uwagi do konstruktora Guid(String) .

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

Uwagi

Alfabetyczne cyfry szesnastkowe w parametrze g mogą być wielkie lub małe. Na przykład następujące ciągi reprezentują ten sam identyfikator GUID:

"ca761232ed4211cebacd00a0057b223"

"CA761232-ED42-11CE-BACD-00A0057B223"

"{CA761232-ED42-11CE-BACD-00A0057B223}"

"(CA761232-ED42-11CE-BACD-00A0057B223)"

"{0xCA761232, 0xED42, 0x11CE, {0xBA, 0xCD, 0x00, 0xAA, 0x00, 0x57, 0xB2, 0x23}}"

Dotyczy

Guid(ReadOnlySpan<Byte>, Boolean)

Źródło:: Guid.cs

Źródło:: 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)

Parametry

b: ReadOnlySpan<Byte>

bigEndian: Boolean

Dotyczy

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

Źródło:: Guid.cs

Źródło:: Guid.cs

Źródło:: Guid.cs

Inicjuje nowe wystąpienie Guid struktury przy użyciu określonych liczb całkowitych i tablicy bajtów.

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

Parametry

a: Int32

Pierwsze 4 bajty identyfikatora GUID.

b: Int16

Następne 2 bajty identyfikatora GUID.

c: Int16

Następne 2 bajty identyfikatora GUID.

d: Byte[]

Pozostałe 8 bajtów identyfikatora GUID.

Wyjątki

ArgumentNullException

d to null.

ArgumentException

d nie ma 8 bajtów długości.

Przykłady

Guid(1,2,3,new byte[]{0,1,2,3,4,5,6,7}) Tworzy obiekt Guid odpowiadający "00000001-0002-0003-0001-020304050607".

Dotyczy

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

Źródło:: Guid.cs

Źródło:: Guid.cs

Źródło:: Guid.cs

Inicjuje Guid nowe wystąpienie struktury przy użyciu określonych liczb całkowitych i bajtów.

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)

Parametry

a: Int32

Pierwsze 4 bajty identyfikatora GUID.

b: Int16

Następne 2 bajty identyfikatora GUID.

c: Int16

Następne 2 bajty identyfikatora GUID.

d: Byte

Następny bajt identyfikatora GUID.

e: Byte

Następny bajt identyfikatora GUID.

f: Byte

Następny bajt identyfikatora GUID.

g: Byte

Następny bajt identyfikatora GUID.

h: Byte

Następny bajt identyfikatora GUID.

i: Byte

Następny bajt identyfikatora GUID.

j: Byte

Następny bajt identyfikatora GUID.

k: Byte

Następny bajt identyfikatora GUID.

Przykłady

Poniższy przykład tworzy identyfikator GUID, którego reprezentacja ciągu to "000000a-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}

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}

Uwagi

Określenie poszczególnych bajtów w ten sposób może służyć do obejścia ograniczeń kolejności bajtów (big-endian lub mało endian kolejności bajtów) na określonych typach komputerów.

Dotyczy

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

Źródło:: Guid.cs

Źródło:: Guid.cs

Źródło:: Guid.cs

Ważne

Ten interfejs API nie jest zgodny ze specyfikacją CLS.

Inicjuje nowe wystąpienie Guid struktury przy użyciu określonych niepodpisanych liczb całkowitych i bajtów.

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)

Parametry

a: UInt32

Pierwsze 4 bajty identyfikatora GUID.

b: UInt16

Następne 2 bajty identyfikatora GUID.

c: UInt16

Następne 2 bajty identyfikatora GUID.

d: Byte

Następny bajt identyfikatora GUID.

e: Byte

Następny bajt identyfikatora GUID.

f: Byte

Następny bajt identyfikatora GUID.

g: Byte

Następny bajt identyfikatora GUID.

h: Byte

Następny bajt identyfikatora GUID.

i: Byte

Następny bajt identyfikatora GUID.

j: Byte

Następny bajt identyfikatora GUID.

k: Byte

Następny bajt identyfikatora GUID.

Atrybuty: CLSCompliantAttribute

Uwagi

Określenie bajtów w ten sposób pozwala uniknąć problemów z endianness.

Dotyczy

Guid Konstruktory

Definicja

Przeciążenia

Guid(Byte[])

Parametry

Wyjątki

Dotyczy

Guid(ReadOnlySpan<Byte>)

Parametry

Wyjątki

Dotyczy

Guid(String)

Parametry

Wyjątki

Przykłady

Uwagi

Dotyczy

Guid(ReadOnlySpan<Byte>, Boolean)

Parametry

Dotyczy

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

Parametry

Wyjątki

Przykłady

Dotyczy

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

Parametry

Przykłady

Uwagi

Dotyczy

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

Parametry

Uwagi

Dotyczy

Opinia

Dodatkowe zasoby