Sdílet prostřednictvím


Guid Konstruktory

Definice

Inicializuje novou instanci Guid struktury.

Přetížení

Guid(Byte[])

Inicializuje novou instanci Guid struktury pomocí zadané pole bajtů.

Guid(ReadOnlySpan<Byte>)

Inicializuje novou instanci Guid struktury pomocí hodnoty reprezentované zadaným rozsahem bajtů jen pro čtení.

Guid(String)

Inicializuje novou instanci Guid struktury pomocí hodnoty reprezentované zadaným řetězcem.

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

Inicializuje novou instanci Guid struktury pomocí zadaných celých čísel a bajtů pole.

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

Inicializuje novou instanci Guid struktury pomocí zadaných celých čísel a bajtů.

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

Inicializuje novou instanci Guid struktury pomocí zadaných celých čísel a bajtů bez znaménka.

Guid(Byte[])

Zdroj:
Guid.cs
Zdroj:
Guid.cs
Zdroj:
Guid.cs

Inicializuje novou instanci Guid struktury pomocí zadané pole bajtů.

public:
 Guid(cli::array <System::Byte> ^ b);
public Guid (byte[] b);
new Guid : byte[] -> Guid
Public Sub New (b As Byte())

Parametry

b
Byte[]

Pole 16 bajtů obsahující hodnoty, pomocí kterých se má inicializovat identifikátor GUID.

Výjimky

b nemá délku 16 bajtů.

Platí pro

Guid(ReadOnlySpan<Byte>)

Zdroj:
Guid.cs
Zdroj:
Guid.cs
Zdroj:
Guid.cs

Inicializuje novou instanci Guid struktury pomocí hodnoty reprezentované zadaným rozsahem bajtů jen pro čtení.

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>

Rozsah jen pro čtení obsahující bajty představující identifikátor GUID. Rozpětí musí být přesně 16 bajtů dlouhé.

Výjimky

Rozpětí musí být přesně 16 bajtů dlouhé.

Platí pro

Guid(String)

Zdroj:
Guid.cs
Zdroj:
Guid.cs
Zdroj:
Guid.cs

Inicializuje novou instanci Guid struktury pomocí hodnoty reprezentované zadaným řetězcem.

public:
 Guid(System::String ^ g);
public Guid (string g);
new Guid : string -> Guid
Public Sub New (g As String)

Parametry

g
String

Řetězec, který obsahuje identifikátor GUID v jednom z následujících formátů ("d" představuje šestnáctkovou číslici, jejíž malá a velká písmena jsou ignorována):

32 souvislých šestnáctkových číslic:

ddddddddd

-nebo-

Skupiny 8, 4, 4, 4 a 12 šestnáctkových číslic se spojovníky mezi skupinami. Celý identifikátor GUID může být volitelně uzavřený do odpovídajících závorek nebo závorek:

ddddddddd-ddddd-ddddd-dddddddddddd

-nebo-

{ddddddddd-dddd-ddddd-ddddddddddddddd}

-nebo-

(ddddddddd-dddd-ddddd-dddddddddddd)

-nebo-

Skupiny s 8, 4 a 4 šestnáctkovými číslicemi a podmnožinou osmi skupin po 2 šestnáctkových číslicích, přičemž každá skupina má předponu "0x" nebo "0X" a oddělenou čárkami. Celý identifikátor GUID i podmnožina jsou uzavřeny do odpovídajících závorek:

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

Všechny složené závorky, čárky a předpony "0x" jsou povinné. Všechny vložené mezery se ignorují. Všechny úvodní nuly ve skupině se ignorují.

Hexadecimální číslice zobrazené ve skupině představují maximální počet smysluplných šestnáctkových číslic, které se můžou v této skupině objevit. Můžete zadat hodnotu od 1 po počet šestnáctkových číslic zobrazených pro skupinu. Zadaná číslice jsou považovány za číslice s nízkým pořadím ve skupině.

Výjimky

Formát parametru g je neplatný.

Formát parametru g je neplatný.

Příklady

Následující příklad předá každý řetězec uvedený v oddílu Poznámky konstruktoru 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

Poznámky

Abecední šestnáctkové číslice v parametru g mohou být velká nebo malá písmena. Například následující řetězce představují stejný identifikátor GUID:

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

Platí pro

Guid(ReadOnlySpan<Byte>, Boolean)

Zdroj:
Guid.cs
Zdroj:
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

bigEndian
Boolean

Platí pro

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

Zdroj:
Guid.cs
Zdroj:
Guid.cs
Zdroj:
Guid.cs

Inicializuje novou instanci Guid struktury pomocí zadaných celých čísel a bajtů pole.

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

První 4 bajty identifikátoru GUID.

b
Int16

Další 2 bajty identifikátoru GUID.

c
Int16

Další 2 bajty identifikátoru GUID.

d
Byte[]

Zbývajících 8 bajtů identifikátoru GUID

Výjimky

d nemá délku 8 bajtů.

Příklady

Guid(1,2,3,new byte[]{0,1,2,3,4,5,6,7}) vytvoří , Guid který odpovídá "00000001-0002-0003-0001-020304050607".

Platí pro

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

Zdroj:
Guid.cs
Zdroj:
Guid.cs
Zdroj:
Guid.cs

Inicializuje novou instanci Guid struktury pomocí zadaných celých čísel a bajtů.

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

První 4 bajty identifikátoru GUID.

b
Int16

Další 2 bajty identifikátoru GUID.

c
Int16

Další 2 bajty identifikátoru GUID.

d
Byte

Další bajt identifikátoru GUID.

e
Byte

Další bajt identifikátoru GUID.

f
Byte

Další bajt identifikátoru GUID.

g
Byte

Další bajt identifikátoru GUID.

h
Byte

Další bajt identifikátoru GUID.

i
Byte

Další bajt identifikátoru GUID.

j
Byte

Další bajt identifikátoru GUID.

k
Byte

Další bajt identifikátoru GUID.

Příklady

Následující příklad vytvoří identifikátor GUID, jehož řetězcové vyjádření je "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}
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}

Poznámky

Zadáním jednotlivých bajtů tímto způsobem lze obejít omezení pořadí bajtů (pořadí bajtů big-endian nebo little-endian) na konkrétních typech počítačů.

Platí pro

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

Zdroj:
Guid.cs
Zdroj:
Guid.cs
Zdroj:
Guid.cs

Důležité

Toto rozhraní API neodpovídá specifikaci CLS.

Inicializuje novou instanci Guid struktury pomocí zadaných celých čísel a bajtů bez znaménka.

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

První 4 bajty identifikátoru GUID.

b
UInt16

Další 2 bajty identifikátoru GUID.

c
UInt16

Další 2 bajty identifikátoru GUID.

d
Byte

Další bajt identifikátoru GUID.

e
Byte

Další bajt identifikátoru GUID.

f
Byte

Další bajt identifikátoru GUID.

g
Byte

Další bajt identifikátoru GUID.

h
Byte

Další bajt identifikátoru GUID.

i
Byte

Další bajt identifikátoru GUID.

j
Byte

Další bajt identifikátoru GUID.

k
Byte

Další bajt identifikátoru GUID.

Atributy

Poznámky

Zadáním bajtů tímto způsobem se vyhnete problémům s koncovostí.

Platí pro